WordPress white screen of death troubleshooting guide

WordPress White Screen of Death: Diagnose PHP and Recovery Mode

by

A WordPress white screen of death can make your entire website, a single page, or even the WordPress admin area appear completely blank.

Sometimes you may see a message such as “There has been a critical error on this website” instead of a blank screen. In both cases, the underlying problem is often a PHP error caused by a plugin, theme, custom code, memory limit, or server configuration.

The good news is that most WordPress white screen problems can be fixed without rebuilding the website.

QUICK ANSWER

If your WordPress site shows a blank white screen, first check your admin email for a WordPress Recovery Mode message. If that does not help, disable plugins, temporarily switch themes, check PHP memory, review recent changes, enable error logging, clear caches, and inspect your hosting error logs.

What Is the WordPress White Screen of Death?

The WordPress White Screen of Death, often shortened to WSOD, happens when WordPress encounters an error but cannot successfully render the page.

You may experience one of several symptoms:

  • The entire website is blank.
  • Only one page is blank.
  • The front end works but wp-admin is blank.
  • The admin area works but visitors see a white screen.
  • You see a WordPress critical error message instead of a completely blank page.

The exact symptom can help identify where the problem is coming from.

1. Check Your WordPress Recovery Mode Email

WordPress includes a built-in Recovery Mode that may activate when a plugin, theme, or custom PHP code causes a fatal error.

Check the administrator email address connected to your WordPress installation. Look for an email explaining that your site is experiencing a technical issue.

The email may identify the plugin or theme that triggered the error and include a special Recovery Mode login link.

If you receive the link, use it to enter your WordPress dashboard and disable the component causing the problem.

If the recovery message never arrives, your website may also have an email delivery problem. See our WordPress Not Sending Email? 9 Fixes guide.

2. Disable All WordPress Plugins

A plugin conflict is one of the most common causes of a WordPress white screen.

If you can still access the dashboard:

  1. Go to Plugins → Installed Plugins.
  2. Select all active plugins.
  3. Choose Deactivate.
  4. Reload the affected page.

If the website starts working again, reactivate the plugins one at a time until the white screen returns.

The last plugin activated is a strong candidate for the conflict.

If You Cannot Access wp-admin

Use your hosting file manager or FTP client and open:

/wp-content/

Rename the folder:

plugins

to something temporary such as:

plugins-disabled

WordPress will no longer be able to load the plugins.

Reload your website. If it works, rename the folder back to plugins and test the plugins individually.

3. Temporarily Switch to a Default WordPress Theme

A broken theme or recently modified theme file can also cause a blank screen.

If you can access the dashboard, go to:

Appearance → Themes

Temporarily activate a standard WordPress theme that is already installed.

If the site begins working normally, your previous theme may contain incompatible PHP code, a broken template, or a conflict with another component.

If you cannot access the dashboard, use your hosting file manager and navigate to:

/wp-content/themes/

Rename the active theme folder temporarily. WordPress may fall back to another available theme.

Do not delete the theme until you know exactly what caused the problem.

4. Check Whether PHP Memory Is Exhausted

WordPress, themes, and plugins all require PHP memory. A site that exceeds the available memory can fail before the page is rendered.

This is especially possible after:

  • installing a large plugin,
  • running a page builder,
  • importing large amounts of data,
  • processing large images,
  • or adding resource-intensive custom code.

Check your hosting control panel for the PHP memory limit and recent PHP errors.

If an error specifically mentions Allowed memory size exhausted, increasing the memory allocation may solve the issue.

Do not keep increasing memory indefinitely. If the site repeatedly consumes excessive memory, identify the plugin, theme, or process responsible.

5. Enable WordPress Error Logging

If disabling plugins and switching themes does not reveal the problem, WordPress debugging can help identify the exact PHP error.

Before editing wp-config.php, make a backup.

Add or verify these settings:

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

Reload the broken page and then check:

/wp-content/debug.log

Look for entries marked as:

  • Fatal error
  • Uncaught error
  • Parse error
  • Memory exhausted
  • Undefined function

The file path shown in the error often reveals the plugin or theme responsible.

After troubleshooting, disable debugging on a production site and avoid leaving sensitive debug logs publicly accessible.

6. Undo the Most Recent Website Change

If the white screen started immediately after a change, investigate that change before modifying unrelated settings.

Think about what happened just before the problem appeared:

  • Was WordPress updated?
  • Was a plugin updated?
  • Was a theme changed?
  • Was PHP upgraded?
  • Was custom code added?
  • Was a code snippet activated?
  • Was a caching or optimization setting changed?

Temporarily reverse the most recent change and reload the site.

If an update appears to be stuck rather than producing a blank page, read our WordPress Stuck in Maintenance Mode? 7 Fixes guide.

7. Clear WordPress, Server, and CDN Caches

A cached broken response can sometimes make a repaired site continue to look broken.

Clear every caching layer your website uses:

  • WordPress caching plugin cache
  • Hosting or server cache
  • Object cache
  • CDN cache
  • Browser cache

Then test the site again in a private or incognito browser window.

Cache clearing will not repair a real PHP fatal error, but it can prevent old cached output from hiding a successful fix.

8. Check PHP Version and Server Error Logs

A plugin or theme that worked with one PHP version may fail after a hosting environment change.

Open your hosting control panel and check:

  • current PHP version,
  • PHP error logs,
  • recent server configuration changes,
  • resource limits,
  • file permissions,
  • and available disk space.

If the error started immediately after changing PHP versions, verify that your theme and essential plugins support the current PHP environment.

Server logs may also reveal errors that WordPress itself cannot display.

If the server is returning a 500 response instead of a blank page, use our WordPress 500 Internal Server Error? 8 Fixes guide.

9. Restore a Known-Good Backup

If the site worked correctly before a recent update or code change and troubleshooting has not identified the cause, restoring a clean backup can be the fastest recovery method.

Before restoring:

  • Back up the current broken site.
  • Confirm the backup date.
  • Check whether new orders, comments, users, or content were created after that backup.
  • Understand whether your host restores files, the database, or both.

After restoration, test the site before applying the same updates again.

If you suspect malicious changes rather than a normal software conflict, follow our WordPress hacked-site recovery guide instead of simply restoring and assuming the problem is solved.

How Do You Know What Caused the White Screen?

The fastest way to troubleshoot is to match the timing of the failure with recent activity.

  • After installing a plugin: disable that plugin first.
  • After updating a theme: switch themes temporarily.
  • After editing PHP: restore the previous code.
  • After changing PHP versions: check compatibility and server logs.
  • After a large import or process: check memory and resource limits.
  • No obvious recent change: use Recovery Mode and error logging.

A structured approach is much safer than randomly changing several settings at once.

Can a WordPress White Screen Fix Itself?

Usually, no.

A temporary server problem may disappear on its own, but a fatal PHP error, plugin conflict, broken theme, or bad custom code will normally return until its cause is corrected.

If the site begins working again without explanation, still check your error logs and recent changes.

Can You Fix a White Screen Without wp-admin?

Yes.

You can troubleshoot a WordPress white screen using:

  • your hosting file manager,
  • FTP or SFTP,
  • WordPress Recovery Mode,
  • PHP error logs,
  • and backups.

If you cannot log in because the login page itself is broken, see WordPress Login Not Working? 8 Fixes.

Final Checklist

  1. Check the Recovery Mode email.
  2. Disable plugins.
  3. Test another theme.
  4. Check PHP memory.
  5. Review the WordPress debug log.
  6. Undo recent changes.
  7. Clear caches.
  8. Check PHP and server logs.
  9. Restore a clean backup if necessary.

Most WordPress white screen problems are caused by a specific plugin, theme, code change, or PHP error. Finding that cause is more effective than repeatedly clearing caches or reinstalling WordPress without a diagnosis.

Leave a Comment