The wordpress white screen of death is the quintessential WordPress nightmare. A completely blank screen with no codes, no messages, and no clue what went wrong. It’s essentially a fatal PHP error that’s being suppressed. At CODE TOT, our first move when facing wordpress white screen of death is to bypass the web interface and use the CLI to see the “naked” error.

Professional Insight: WSOD is often caused by a plugin conflict during an automatic background update. If you use a caching plugin like WP Rocket or W3 Total Cache, the empty page might actually be “cached,” so always purge your server cache (Redis/Varnish) before you start debugging.

1. Emergency Debugging via wp-config.php

Without debug mode, you are guessing. Enable these settings to force WordPress to write all errors to a private log file instead of showing them to users:

# In wp-config.php
define( 'WP_DEBUG', true );
define( 'WP_DEBUG_LOG', true );
define( 'WP_DEBUG_DISPLAY', false );

Check the file at wp-content/debug.log immediately after refreshing the blank page. It will tell you the exact file and line number causing the crash.

2. The “Binary Search” Deactivation

If you can’t access the dashboard, use WP-CLI to deactivate all plugins at once. If the site comes back, you know it’s a plugin issue. Then, re-enable them one by one to find the culprit:

# Deactivate all plugins via SSH
wp plugin deactivate --all

For more wordpress white screen of death fixes, see our guide on fixing WordPress critical errors.

3. Managing “Hidden” MU-Plugins

Sometimes you deactivate all plugins and the WSOD persists. Check your wp-content/mu-plugins/ folder. These Must-Use plugins are loaded automatically and cannot be managed from the dashboard. They often contain critical integration code that can easily cause a blank screen if there’s a typo.

4. Incompatible PHP Versions

If you’re on a VPS managed by RunCloud, check your PHP version for the specific Web Application. If you recently upgraded to PHP 8.1 or 8.2 and see a wordpress white screen of death, your theme might be using old syntax that’s no longer supported. Reverting to a slightly older PHP version (like 7.4 or 8.0) is a quick way to test if your code is outdated.

wordpress white screen of death fix WSOD troubleshooting
Fix wordpress white screen of death with WP_DEBUG and WP-CLI

Conclusion

The White Screen of Death is just a silent error. By enabling debug logs, using WP-CLI for deactivation, and checking your must-use plugins, you can lift the veil and get your site back online.

For more troubleshooting, check out WPBeginner’s WSOD Guide and WordPress Official Debugging Docs.