How to Fix the WordPress White Screen of Death (Step-by-Step)

The WordPress White Screen of Death (WSoD) is one of the most frustrating errors — your site displays nothing but a blank white page, with no error message to guide you. This usually indicates a PHP fatal error that WordPress can’t display. The good news: WSoD is fixable with systematic troubleshooting.

What Causes the White Screen of Death?

WSoD typically stems from PHP memory exhaustion, plugin or theme conflicts, or corrupted core files. When PHP hits its memory limit or encounters a fatal error, WordPress stops rendering the page entirely. Common triggers include installing incompatible plugins, updating a theme that breaks the site, or uploading corrupted files via FTP.

Step 1: Enable WordPress Debug Mode

The first step is making the error visible. Edit your wp-config.php file and add or modify these lines:

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

This logs errors to /wp-content/debug.log without displaying them publicly. Check this file and the last error entry will usually pinpoint the problematic plugin or theme file.

Step 2: Increase PHP Memory Limit

Memory exhaustion is a frequent WSoD cause. In wp-config.php, add:

define('WP_MEMORY_LIMIT', '256M');

If your host restricts this, contact support. Most modern WordPress sites need at least 128MB, preferably 256MB of PHP memory.

Step 3: Deactivate All Plugins

Plugin conflicts are the most common WSoD cause. Since you can’t access wp-admin, use FTP or your hosting file manager to rename the /wp-content/plugins/ folder to /wp-content/plugins-temp/. This deactivates all plugins instantly. If your site loads, rename the folder back and reactivate plugins one by one to find the culprit.

Step 4: Switch to a Default Theme

If plugins aren’t the cause, the theme might be. Via FTP, rename your active theme folder (e.g., /wp-content/themes/graceful/ to /graceful-temp/). WordPress automatically falls back to a default theme like Twenty Twenty-Five. If your site loads, your theme is the problem — reinstall it or contact the developer.

Step 5: Re-upload Core WordPress Files

Corrupted core files can cause WSoD. Download a fresh copy of WordPress from wordpress.org and upload only the wp-admin and wp-includes folders via FTP, overwriting existing files. This preserves your wp-content (themes, plugins, uploads) while restoring core integrity.

Frequently Asked Questions

Why does WSoD only affect certain pages? If WSoD appears on specific pages but not others, the issue is likely a plugin or theme function tied to that page type. Enable debug logging and check which file throws the error on those URLs.

Can WSoD be caused by a hosting issue? Yes — server misconfigurations, exhausted disk space, or PHP version changes can trigger WSoD. Check your hosting dashboard for resource limits and PHP error logs at the server level.

How do I prevent WSoD in the future? Always test plugin and theme updates on a staging site first. Maintain regular backups. Use a managed WordPress host that monitors for fatal errors. Keep PHP version current.

Conclusion

The White Screen of Death looks scary but is almost always fixable. Work through the steps systematically: enable debugging, increase memory, deactivate plugins, switch themes, re-upload core files. The culprit reveals itself quickly when you isolate components one at a time.