Fixing the WordPress white screen of death
Step-by-step debugging when your WordPress site goes completely blank. Plugin conflicts, memory limits, and the .htaccess gotcha.
Step-by-step debugging when your WordPress site goes completely blank. Plugin conflicts, memory limits, and the .htaccess gotcha.
You opened your site and got nothing. Just a blank white page. No error message, no theme, no admin login. This is the WordPress “white screen of death” (WSOD) and it’s one of the most common WordPress problems. The good news: it’s almost always fixable in under 30 minutes once you know the order to check things.
WordPress hides errors by default. Turn them on temporarily.
Connect via SFTP or use the File Manager in your hosting panel. Open wp-config.php and find this line:
define( 'WP_DEBUG', false );
Change it to:
define( 'WP_DEBUG', true );
define( 'WP_DEBUG_LOG', true );
define( 'WP_DEBUG_DISPLAY', false );
Now errors are written to /wp-content/debug.log instead of being silent. Reload your site, then check that log file. The last error before things broke usually tells you the cause.
Remember to turn debug mode off when you’re done — leaving it on in production is a security risk.
Symptom: white screen started after activating, updating, or removing a plugin.
Fix without admin access:
/wp-content/plugins folder to plugins-disabledIf it works now, the issue is a plugin. Rename back to plugins, then deactivate plugins one at a time (rename individual plugin folders) until you find the culprit.
Fix with admin access:
Symptom: white screen after changing themes, or after a theme auto-update.
Fix: rename /wp-content/themes/your-active-theme/ to your-active-theme-broken. WordPress falls back to the default Twenty-something theme. If the site loads now, your theme is the problem — restore from backup or contact the theme developer.
Symptom: WSOD only on specific pages, especially admin pages like the editor or plugins list.
WordPress can run out of allocated PHP memory, especially with bloated plugins. To increase the limit, add this to wp-config.php above the “That’s all, stop editing!” line:
define( 'WP_MEMORY_LIMIT', '512M' );
define( 'WP_MAX_MEMORY_LIMIT', '512M' );
If you’re on a Starter or Standard plan and hitting memory limits often, you’ve likely outgrown the tier — Business plans have more headroom by design.
Symptom: white screen with weird URL behaviour, or 500 errors mixed in.
A plugin or update can corrupt your .htaccess file. To fix:
.htaccess to .htaccess.brokenIf it works, the .htaccess was corrupt. To regenerate a clean one:
WordPress writes a fresh .htaccess.
Symptom: WSOD right after a WordPress core update that got interrupted.
Look for a .maintenance file in your site root. If it’s there, the update was interrupted. Delete the file. If WordPress still doesn’t load, you may need to manually re-upload WordPress core files (download from wordpress.org, upload everything except wp-content/ and wp-config.php).
If you’ve tried all the above and still have a white screen, open a ticket with:
debug.log (don’t skip this — it usually pinpoints the cause)We’ve seen every flavour of WSOD. With those details we can usually identify the cause in under an hour.
Let us know — or open a ticket if you're still stuck.