How to Fix the WordPress White Screen of Death

The WordPress white screen of death is one of the most alarming errors a site owner can encounter — your entire website goes blank, showing nothing but an empty white page with no error message to guide you. Despite how serious it looks, this issue is almost always fixable once you understand the common causes and know the right steps to take. This guide walks you through every proven method to diagnose and resolve it.

What Causes the WordPress White Screen of Death?

Before diving into fixes, it helps to understand why this error occurs in the first place. The white screen of death (WSOD) typically happens when PHP encounters a fatal error and fails silently, or when your server runs out of memory. WordPress suppresses error output by default on live sites, which is why you see a blank page instead of a useful message.

Common Causes

PHP memory exhaustion — A script exceeds the allowed memory limit and crashes.
Faulty plugins — A recently installed or updated plugin introduces a fatal PHP error.
Broken or incompatible themes — A theme update or new activation corrupts the front end.
PHP version incompatibility — Your host upgraded PHP and an old plugin or theme is not compatible.
Corrupted WordPress core files — Incomplete updates or malware can corrupt core files.
Syntax errors in wp-config.php or functions.php — A manual edit introduced a typo.

Who Is Affected?

The WSOD can affect just the front end, just the WordPress admin dashboard, or both. Identifying which area is broken narrows down the cause significantly. If only the admin is blank, a plugin conflict is the most likely culprit. If only the front end is blank, the active theme is usually responsible.

Step 1 — Enable WordPress Debug Mode

The single most useful first step is turning on WordPress debug mode so PHP errors are displayed rather than hidden. This instantly tells you which file and line number is causing the problem.

Connect to your server using FTP, SFTP, or your host's File Manager.
Navigate to the root of your WordPress installation and open wp-config.php.
Locate the line that reads define( 'WP_DEBUG', false ); and replace the entire debug block with the following:

// Enable debug mode and log errors to a file
define( 'WP_DEBUG', true );
define( 'WP_DEBUG_LOG', true );
define( 'WP_DEBUG_DISPLAY', true );
@ini_set( 'display_errors', 1 );

Save the file and reload your website in the browser.
If an error message now appears, read it carefully — it will name the exact file and line number at fault.
Also check the file wp-content/debug.log for a full error history.

Important: Remember to set WP_DEBUG back to false after you have resolved the issue, so error details are not exposed to public visitors.

Step 2 — Increase the PHP Memory Limit

Memory exhaustion is one of the most frequent triggers of the white screen of death. WordPress requires at least 64 MB of PHP memory, but complex sites with many plugins often need 256 MB or more. You can raise the limit in several ways.

Method A: Edit wp-config.php

Add the following line to wp-config.php just before the line that reads /* That's all, stop editing! */:

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

Method B: Edit php.ini

If your host gives you access to php.ini, find or add this line:

memory_limit = 256M

Method C: Edit .htaccess

On Apache servers, add this line to your .htaccess file in the WordPress root:

php_value memory_limit 256M

After making any of these changes, reload your site to see if the white screen has cleared.

Step 3 — Disable All Plugins

If the memory fix did not resolve the issue, a faulty plugin is the next most likely cause. The goal is to deactivate every plugin at once and then reactivate them one by one to find the offender.

When You Can Access the Admin Dashboard

Log in to wp-admin.
Go to Plugins > Installed Plugins.
Check the box at the top of the list to select all plugins.
From the Bulk Actions dropdown, choose Deactivate and click Apply.
Reload your website — if the white screen is gone, a plugin was responsible.
Reactivate plugins one at a time, reloading after each, until the WSOD returns. The last plugin you activated is the culprit.

When You Cannot Access the Admin Dashboard

Connect via FTP or File Manager.
Navigate to wp-content/plugins/.
Rename the entire plugins folder to something like plugins_disabled. WordPress will automatically deactivate all plugins.
Reload the site. If it works, rename the folder back to plugins.
Now enter the plugins folder and rename individual plugin folders, reloading after each, to isolate the bad one.

Using WP-CLI to Deactivate Plugins

If you have command-line access to your server, WP-CLI provides the fastest method:

wp plugin deactivate --all

Once you have identified the problem plugin, update it or contact its developer for a compatibility fix.

Step 4 — Switch to a Default Theme

If disabling plugins did not fix the white screen, your active theme is likely at fault. Switching to a default WordPress theme such as Twenty Twenty-Four will confirm this.

Via the Admin Dashboard

Go to Appearance > Themes.
Hover over a default theme (e.g., Twenty Twenty-Four) and click Activate.
Reload your site to check whether the WSOD is resolved.

Via FTP When Admin Is Inaccessible

Connect via FTP or File Manager.
Navigate to wp-content/themes/.
Rename your active theme's folder (e.g., rename my-theme to my-theme-backup). WordPress will fall back to the next available theme automatically.
Reload the site. If the white screen clears, your theme was causing the error.
Contact the theme developer or update to the latest version of the theme before reactivating it.

Via WP-CLI

wp theme activate twentytwentyfour

Step 5 — Re-upload Core WordPress Files and Check for Corruption

If neither plugins nor your theme are the cause, corrupted WordPress core files may be responsible. This can happen after a failed auto-update, a server crash, or a malware infection.

Re-upload WordPress Core

Download a fresh copy of WordPress from wordpress.org/download.
Extract the ZIP file on your local computer.
Delete the wp-content folder and the wp-config.php file from the extracted package — you must not overwrite these on the server as they contain your site data and settings.
Upload all remaining files and folders to your server, overwriting the existing ones when prompted.
Reload your website and check whether the WSOD is resolved.

Check for Malware

If you suspect malware, install a security plugin such as Wordfence (you can do this even via WP-CLI: wp plugin install wordfence --activate) and run a full scan. Malware often injects code into core files that causes fatal PHP errors and triggers the white screen.

Repair the WordPress Database

A corrupted database can also cause a blank screen. Enable the built-in repair tool by adding this line to wp-config.php:

define( 'WP_ALLOW_REPAIR', true );

Then visit https://yoursite.com/wp-admin/maint/repair.php in your browser and click Repair Database. Remove the line from wp-config.php once the repair is complete.

Additional Troubleshooting Tips

If the steps above have not yet resolved the issue, the following additional checks often uncover the root cause.

Check Your PHP Version

Log in to your hosting control panel (cPanel, Plesk, etc.) and check which PHP version your site is running. WordPress 6.x requires PHP 7.4 or higher, with PHP 8.1+ recommended. If your host recently auto-upgraded PHP, an older plugin or theme may not be compatible. Try switching to a slightly older but still supported PHP version to confirm this is the cause.

Review Your Server Error Logs

Your hosting control panel almost always provides access to PHP and Apache/Nginx error logs. These logs record fatal errors even when WordPress itself cannot display them. Common locations include /var/log/apache2/error.log on Linux servers or inside cPanel under Errors in the Metrics section.

Clear All Caches

A caching plugin or a server-level cache can sometimes serve a cached blank page even after the underlying issue has been fixed. Clear your caching plugin's cache, your CDN cache (e.g., Cloudflare), and any object caches such as Redis or Memcached. If you use WP-CLI you can flush the object cache instantly:

wp cache flush

Restore From a Backup

If none of the above steps resolve the issue and you have a recent clean backup, restoring from that backup is often the fastest path back to a working site. Use your hosting provider's backup restore tool, or restore manually by uploading the backed-up files and importing the database.

Frequently Asked Questions

Why does the WordPress white screen of death show no error message?

By default, WordPress hides PHP error output on live sites to prevent sensitive information from being shown to visitors. This means fatal errors fail silently and produce a blank white page. Enabling WP_DEBUG in wp-config.php forces these errors to be displayed so you can diagnose the problem.

Can the white screen of death cause data loss?

The WSOD itself does not delete or corrupt your database content. It is a display error caused by a PHP crash. Your posts, pages, and settings remain intact in the database. However, if the error was caused by a failed WordPress update, some files may be incomplete — which is why re-uploading core files is one of the recommended fixes.

How do I fix the WordPress white screen of death if I cannot access wp-admin?

When the admin dashboard is also showing a white screen, use FTP or your host's File Manager to access your server directly. You can rename the plugins folder to deactivate all plugins, rename your theme folder to revert to a default theme, and edit wp-config.php to enable debug mode — all without needing to log in to WordPress.

How can I prevent the white screen of death in future?

Keep WordPress core, themes, and plugins updated regularly. Always test updates on a staging site before applying them to production. Maintain automatic daily backups, set a sufficient PHP memory limit proactively, and use a managed WordPress host that monitors for PHP fatal errors. Removing unused plugins and themes also reduces the risk of conflicts.

Dealing with the WordPress white screen of death is frustrating, but every cause has a clear solution once you know where to look. If you would rather skip the manual troubleshooting entirely, WP AI Agent is an AI-powered tool that lets you diagnose and fix common WordPress errors — including the white screen of death — simply by describing the problem in plain language chat, making complex server-level fixes accessible to everyone.

How to Fix the WordPress White Screen of Death (Complete Guide)