The "White Screen of Death" (WSoD) is a blank white page that appears instead of your website content. This occurs in WordPress when a PHP fatal error occurs, but the site is not configured to display the specific error message to the public.
Before you begin
You will need:
Administrator access to your WordPress site via a method other than the web interface (such as FTP, SFTP, or a File Manager).
Access to your site's files and database.
Check the WordPress debug log
Because the "White Screen of Death" hides the specific error, you must enable WordPress's internal logging to see what is causing the failure.
Connect to your site's files using an FTP client or a File Manager.
Locate the
wp-config.phpfile in the root directory of your WordPress installation.Open
wp-config.phpand find the line:define( 'WP_DEBUG', false );Change the value from
falsetotrue:define( 'WP_DEBUG', true );If the line does not exist, add it above the line that says
/* That's all, stop editing! Happy publishing. */.Save the file and refresh your website.
Instead of a blank white page, the site should now display a specific error message, including a file path and a line number.
Identify the cause of the error
Once the error message is visible, use it to determine which component is failing.
If the error mentions a plugin
If the file path in the error message includes the name of a specific plugin (e.g., /wp-content/plugins/plugin-name/...), that plugin is causing the crash.
Connect to your site's files via FTP or File Manager.
Navigate to
wp-content/plugins/.Rename the folder of the problematic plugin (e.g., rename
plugin-nametoplugin-name_old).Refresh your website. The site should now load, and the specific plugin will be deactivated.
If the error mentions a theme
If the file path includes your active theme (e.g., /wp-content/themes/theme-name/...), the theme is causing the crash.
Connect to your site's files via FTP or File Manager.
Navigate to
wp-content/themes/.Rename the folder of the active theme (e.g., rename
theme-nametotheme-name_old).Refresh your website. WordPress will automatically fall back to a default theme, and the site should load.
Disable WordPress debugging
Once you have identified and resolved the issue, you must turn off the debug mode to ensure your site remains secure and professional.
Open your
wp-config.phpfile again.Locate the line:
define( 'WP_DEBUG', true );Change the value back to
false:define( 'WP_DEBUG', false );Save the file.
Confirm the result
The "White Screen of Death" is gone, and your website content is visible.
The specific error message is no longer displayed on the front end of the site.
Limitations
This procedure identifies the source of the error but does not fix the underlying code issue within a plugin or theme. You may need to contact the developer of the specific plugin or theme to report the bug or update the software to a stable version.
