How to Fix the WordPress White Screen of Death (WSoD)

The WordPress White Screen of Death (WSoD) is one of the most common and frustrating errors. It usually locks you out of both your site’s front-end and the admin dashboard, displaying absolutely nothing but a blank white screen.

In this guide, we’ll walk through the major causes of the WSoD and provide actionable solutions and code fixes to get your site back online.

What Causes the White Screen of Death?

The WSoD is usually caused by PHP errors or database errors. The most common culprits are:

  • A plugin compatibility issue or poorly coded plugin.
  • A malfunctioning theme.
  • Exhausted PHP memory limits.

How to Fix It

1. Enable WordPress Debugging

The first step in fixing a white screen is finding out why it’s happening. WordPress has a built-in debugging feature that will output the hidden PHP errors to the screen.

The Fix:
Open your wp-config.php file via FTP or File Manager, and look for the following line:

define( 'WP_DEBUG', false );

Change it to:

define( 'WP_DEBUG', true );
define( 'WP_DEBUG_LOG', true );
define( 'WP_DEBUG_DISPLAY', false );

This will log errors to a debug.log file inside your /wp-content/ directory, allowing you to see exactly which plugin or theme is causing the fatal error.

2. Increase the PHP Memory Limit

If a script exhausts your server’s allocated memory, it will crash and cause the WSoD.

The Fix:
You can increase the memory limit by adding this code snippet to your wp-config.php file, just before the line that says /* That's all, stop editing! Happy blogging. */:

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

If this doesn’t work, you may need to update your .htaccess file:

php_value memory_limit 256M

3. Disable All Plugins

If you cannot access your dashboard, you will need to disable your plugins via FTP.

The Fix:

  1. Connect to your site via FTP.
  2. Navigate to wp-content.
  3. Rename the plugins folder to plugins_old.
  4. Check your website. If it loads, a plugin was the culprit.
  5. Rename the folder back to plugins, and then activate your plugins one by one from the dashboard until the site breaks again to isolate the problematic plugin.

4. Switch to a Default Theme

If plugins aren’t the issue, your theme might be.

The Fix:

  1. Access your site via FTP.
  2. Navigate to wp-content/themes/.
  3. Rename your active theme’s folder (e.g., my-theme to my-theme_disabled).
  4. WordPress will automatically fall back to a default theme like Twenty Twenty-Four if it is installed. Check if your site loads.

By systematically going through these steps, you can identify and resolve the White Screen of Death and secure your WordPress installation.