Fixing the WordPress White Screen of Death

The "White Screen of Death" (WSOD) is a frustrating but common WordPress problem — your site or dashboard shows a completely blank white page with no error message. It is almost always caused by a PHP error triggered by a plugin, theme, or resource limit. This article walks you through the steps to identify and fix the cause.

Blank white browser window beside a five-step diagnostic flow: Enable WP_DEBUG, Disable Plugins, Switch Theme, Increase Memory, Re-enable and identify culprit

Common Causes

  • A plugin that has just been installed, updated, or activated
  • A theme conflict, usually after a theme update or switch
  • A PHP memory limit that has been reached
  • A corrupted wp-config.php or core file
  • A PHP syntax error introduced by a code edit

Step 1: Enable Error Reporting

By default, WordPress suppresses PHP errors, which is why you see a blank screen instead of a useful message. Enable debug mode to reveal the underlying error.

  1. In cPanel > File Manager, navigate to your WordPress root directory and open wp-config.php.
  2. Find the line:
    define( 'WP_DEBUG', false );
    
  3. Change it to:
    define( 'WP_DEBUG', true );
    define( 'WP_DEBUG_LOG', true );
    define( 'WP_DEBUG_DISPLAY', false );
    
  4. Save the file and reload your site.

Errors are now written to wp-content/debug.log. Open that file in File Manager to read the error message — it will usually name the exact plugin or theme file responsible.

Important: Turn debug mode off again once you have resolved the issue by setting WP_DEBUG back to false.

Step 2: Deactivate All Plugins

A plugin conflict is the most common cause of the WSOD. Deactivate all plugins at once by renaming the plugins folder — this works even when you cannot access the dashboard.

  1. In cPanel > File Manager, navigate to public_html/wp-content/.
  2. Right-click the plugins folder and rename it to plugins_disabled.
  3. Reload your site or dashboard.

If the white screen is gone, a plugin was the cause. Re-enable plugins one by one to identify the culprit:

  1. Rename plugins_disabled back to plugins.
  2. In your dashboard, go to Plugins > Installed Plugins.
  3. Activate each plugin individually, reloading the site after each one until the white screen returns.
  4. The last plugin you activated is the problem — leave it deactivated and contact the plugin developer or find an alternative.

Step 3: Switch to a Default Theme

If disabling plugins does not fix the issue, the active theme may be the cause.

  1. In cPanel > File Manager, navigate to public_html/wp-content/themes/.
  2. Rename your active theme's folder (e.g. rename mytheme to mytheme_disabled).
  3. WordPress will automatically fall back to a default theme.
  4. Reload your site to see if the white screen is resolved.

If it is, the theme was the problem. Check for an available theme update, or contact the theme developer.

Step 4: Increase the PHP Memory Limit

WordPress may run out of memory mid-execution, which can produce a blank screen.

  1. In cPanel > File Manager, open public_html/.htaccess.
  2. Add the following line:
    php_value memory_limit 256M
    
  3. Save and reload your site.

Alternatively, add this line to wp-config.php before the /* That's all, stop editing! */ comment:

define( 'WP_MEMORY_LIMIT', '256M' );

Step 5: Check for a Corrupted wp-config.php

If none of the above steps resolve the issue, your wp-config.php may have been corrupted by a failed edit.

  1. Open wp-config.php in cPanel > File Manager > Code Editor.
  2. Look for stray characters, especially at the very beginning or end of the file — there should be nothing before <?php and nothing after the closing ?> (if present).
  3. Remove any stray whitespace or characters and save.

Step 6: Restore from a Backup

If you have exhausted the steps above without finding a cause, restoring a recent backup is the fastest path to a working site.

  1. Log in to cPanel and open Softaculous Apps Installer.
  2. Click WordPress, then Installations.
  3. Click the Restore icon next to your site and select a backup taken before the issue appeared.

For assistance diagnosing a persistent white screen, contact CyclebreezeHost support at info@cyclebreezehost.com — our team is available 24/7.