ZeroToWP

White Screen of Death

Quick Definition

The White Screen of Death (WSOD) is a blank white page that appears when WordPress encounters a fatal PHP error. It is one of the most common WordPress problems and is almost always fixable.

WPBeginner guide on fixing the WordPress White Screen of Death

What Is the White Screen of Death?

The White Screen of Death (WSOD) is exactly what it sounds like: you visit your WordPress site and see nothing but a blank white page. No error message, no content, no admin dashboard — just white. It happens when PHP encounters a fatal error that stops execution before WordPress can render anything.

The most common causes are:

  • Plugin conflict — A recently installed or updated plugin crashes, taking the entire site down with it. This is the #1 cause.
  • Memory exhaustion — Your site's PHP scripts use more memory than the server allows. The default WordPress memory limit is 40MB, which can be insufficient for complex sites.
  • Theme error — A broken theme file — often functions.php — contains a syntax error or calls a function that does not exist.
  • Corrupted core files — An interrupted WordPress update can corrupt core files, leaving the site in a broken state.
  • File permission issues — Incorrect file permissions can prevent WordPress from reading essential files.

Since WordPress 5.2, a Recovery Mode feature catches fatal errors and sends an email to the admin with a special login link. This link lets you access the dashboard even when the front end is broken, so you can deactivate the problem plugin or switch themes. Check your email first — Recovery Mode solves most WSOD cases without any technical skills.

How to Fix the White Screen of Death

If Recovery Mode does not help, work through these steps in order:

  1. Enable WP_DEBUG — Add define( 'WP_DEBUG', true ); to wp-config.php via FTP. This reveals the actual PHP error message instead of the blank screen.
  2. Disable all plugins — Rename the wp-content/plugins folder to plugins-disabled via FTP. If the site comes back, reactivate plugins one by one to find the culprit.
  3. Switch to a default theme — Rename your active theme folder. WordPress falls back to Twenty Twenty-Five (or the latest default theme). If the site loads, your theme is the problem.
  4. Increase memory limit — Add define( 'WP_MEMORY_LIMIT', '256M' ); to wp-config.php to give PHP more room.
  5. Clear cache — If you use a caching plugin, delete cached files from wp-content/cache via FTP.
  6. Reinstall core — Download a fresh copy of WordPress from wordpress.org and upload the wp-admin and wp-includes folders (do not touch wp-content).

Why It Matters

The WSOD is terrifying when it first happens — your entire site disappears. But it is almost always fixable, and knowing the systematic troubleshooting steps turns a panic moment into a 10-minute fix. The key is having FTP access, backups, and the confidence to follow the steps. If you run a WordPress site long enough, you will encounter the WSOD at least once — being prepared makes all the difference.

Sources

Related Terms

Related Articles