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

If you’ve reached this page, you’re likely staring at a blank, white browser window where your website used to be. The “White Screen of Death” (WSoD) is one of the most frustrating WordPress errors because it usually provides no error message and locks you out of your admin dashboard.

I remember the first time it happened to me – I froze. However, over the years, I’ve learned that while it looks catastrophic, it is almost always fixable.

wordpress white screen of death (wsod)
The Dreaded White Screen of Death in WordPress

The Good News: WordPress Now Has Built-in Protection

Since version 5.2, WordPress includes a Site Health Check feature with “Fatal Error Protection.” Now, if a plugin or theme causes a crash, WordPress often catches it, displays a message saying “The site is experiencing technical difficulties,” and sends an email to the admin with a “Recovery Mode” link.

If you aren’t seeing that link or are on an older version of WordPress, don’t panic. Follow the steps below to bring your site back online.

Common Causes of the White Screen of Death

Before we dive into the fixes, it helps to understand why this happens. The most common culprits include:

  • Incompatible or poorly coded plugins/themes.
  • Exhausted PHP memory limits.
  • Corrupt .htaccess or core files.
  • Server-side issues with your web host.

⚠️ A Word of Caution: Some of these methods require editing core WordPress files. Always take a complete backup of your site (via your hosting control panel or FTP) before making changes.

Step-by-Step Troubleshooting Guide

Rule Out Browser Issues

Sometimes, the “white screen” is just a local caching glitch.

  • Clear your cache: Clear your browser cookies and history.
  • Try Incognito Mode: If the site loads in a private window, your browser cache was the culprit.
  • Use an External Tool: Check your URL on GTmetrix or BrowserStack Website Scanner. If they show a preview of your site, the issue is local to your computer.

Increase the PHP Memory Limit

If your site has outgrown its allocated memory—often due to a heavy plugin—the script will simply quit, leaving a blank screen.

To fix this, you need to edit your wp-config.php file:

  1. Access your site via FTP or your host’s File Manager.
  2. Open wp-config.php and look for the line: /* That's all, stop editing! Happy blogging. */.
  3. Paste the following code right above that line: define( 'WP_MEMORY_LIMIT', '256M' );
  4. Save and refresh your site. If the error persists, try increasing it to 512M.

Disable All Plugins (The Most Likely Fix)

A plugin conflict is the cause of WSoD about 80% of the time. If you can’t access your dashboard, you can disable them via FTP:

  1. Navigate to the /wp-content/ folder.
  2. Rename the plugins folder to plugins_old. This instantly deactivates every plugin on your site.
  3. Check your site. If it loads, a plugin was the problem!
  4. To find the culprit: Rename the folder back to plugins. Go into the folder and rename each individual plugin folder one by one (e.g., contact-form-7_old) until the site breaks again. The last one you touched is the offender.

Check for Corrupt Core Files

reinstall wordpress

If you recently edited your .htaccess or functions.php file, even a tiny typo or an extra whitespace can crash the entire system.

  • The .htaccess Trick: Rename your .htaccess file to .htaccess_old. If the site loads, go to Settings > Permalinks in your dashboard and click “Save” to generate a fresh, clean file.
  • Reinstalling WordPress: If you suspect core files are corrupted, download a fresh copy of WordPress from WordPress.org. Upload the files via FTP, overwriting everything EXCEPT the wp-content folder and the wp-config.php file.

Enable WordPress Debug Mode

If the site is still white, you need to make WordPress “tell” you what’s wrong.

  1. Open wp-config.php and find define( 'WP_DEBUG', false );.
  2. Change it to true. If the line isn’t there, add this to the top:PHPdefine( 'WP_DEBUG', true ); define( 'WP_DEBUG_LOG', true ); define( 'WP_DEBUG_DISPLAY', true );
  3. Refresh your site. Instead of a white screen, you will now see specific error messages. Look for a file path—it will usually point to a specific plugin or theme folder, telling you exactly where the “fatal error” is.

Contact Your Web Host

If none of the above worked, the issue might be server-side (like a failed PHP update or a database server outage). Reliable hosts like Bluehost, SiteGround, or GreenGeeks have 24/7 live support. Reach out and ask them to check the error logs. They can see “under the hood” and often fix the issue for you in minutes.

Conclusion

The White Screen of Death is a rite of passage for WordPress users. Usually, it’s just a matter of memory limits or a rogue plugin. By following these steps, starting with the simplest fixes and moving toward the technical ones you can get your site back online without losing any data.

Was this guide helpful? If so, consider sharing it with your fellow bloggers! You might just save them from a major headache the next time their site goes blank.


Discover more from Antony Agnel

Subscribe to get the latest posts sent to your email.

2 thoughts on “How to Fix the WordPress White Screen of Death (WSoD)”

Join the conversation

Discover more from Antony Agnel

Subscribe now to keep reading and get access to the full archive.

Continue reading