Skip to main content

How to Troubleshoot the WordPress White Screen of Death

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.

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.

  1. Connect to your site's files using an FTP client or a File Manager.

  2. Locate the wp-config.php file in the root directory of your WordPress installation.

  3. Open wp-config.php and find the line: define( 'WP_DEBUG', false );

  4. Change the value from false to true: define( 'WP_DEBUG', true );

  5. If the line does not exist, add it above the line that says /* That's all, stop editing! Happy publishing. */.

  6. 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.

  1. Connect to your site's files via FTP or File Manager.

  2. Navigate to wp-content/plugins/.

  3. Rename the folder of the problematic plugin (e.g., rename plugin-name to plugin-name_old).

  4. 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.

  1. Connect to your site's files via FTP or File Manager.

  2. Navigate to wp-content/themes/.

  3. Rename the folder of the active theme (e.g., rename theme-name to theme-name_old).

  4. 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.

  1. Open your wp-config.php file again.

  2. Locate the line: define( 'WP_DEBUG', true );

  3. Change the value back to false: define( 'WP_DEBUG', false );

  4. 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.

Did this answer your question?