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

The WordPress white screen of death (WSoD) is one of the most frustrating errors a site owner can encounter — your website simply displays a blank white page with no error message, no clues, and no obvious way forward. Whether it affects your front end, your admin dashboard, or both, this guide walks you through every proven fix so you can get your WordPress site back online as quickly as possible.

What Causes the WordPress White Screen of Death?

Before diving into fixes, it helps to understand why the white screen of death happens. WordPress is a PHP-based application, and when a fatal PHP error occurs, the server often suppresses the output entirely — leaving you with a blank screen. Common culprits include:

• A faulty plugin — a recently installed or updated plugin introduces a PHP conflict.
• A broken theme — a theme update or customisation causes a fatal error.
• Memory exhaustion — WordPress runs out of PHP memory and cannot complete page rendering.
• Corrupted WordPress core files — a failed update leaves core files in a broken state.
• Syntax errors in wp-config.php or functions.php — a misplaced character breaks the entire site.

Identifying which category applies to your situation is the first step toward a targeted fix.

Step 1 — Enable WordPress Debug Mode

The single most important action you can take is to turn on WordPress debugging. Debug mode forces PHP to output error messages instead of hiding them, telling you exactly which file and line number caused the problem.

1. Connect to your server using FTP, SFTP, or your hosting control panel's file manager.
2. Navigate to the root of your WordPress installation and open wp-config.php.
3. Locate the line define( 'WP_DEBUG', false ); — if it does not exist, add the following block just above the line that reads /* That's all, stop editing! */:

define( 'WP_DEBUG', true );
define( 'WP_DEBUG_LOG', true );
define( 'WP_DEBUG_DISPLAY', true );
@ini_set( 'display_errors', 1 );

4. Save the file and reload your website in a browser.
5. If a PHP error is now visible on screen, note the file name and line number — this tells you exactly where the problem is.
6. You can also check the automatically generated log file at wp-content/debug.log for a full history of errors.

Important: Always disable debug mode (set WP_DEBUG back to false) once you have resolved the issue, as displaying errors on a live site is a security risk.

Step 2 — Deactivate All Plugins

Plugins are the most common cause of the WordPress white screen of death. If debug mode pointed to a plugin file, or if you recently installed or updated a plugin, deactivating all plugins is the fastest way to confirm this theory.

If You Can Access the WordPress Admin

1. Log in to your WordPress dashboard.
2. Go to Plugins > Installed Plugins.
3. Check the box at the top of the list to select all plugins.
4. From the Bulk Actions dropdown, choose Deactivate and click Apply.
5. Reload your site. If the white screen is gone, a plugin was the cause.
6. Reactivate plugins one by one, reloading after each, until the white screen returns — the last plugin you activated is the culprit.

If You Cannot Access the WordPress Admin

1. Connect via FTP or your file manager.
2. Navigate to wp-content/plugins/.
3. Rename the entire plugins folder to something like plugins_disabled. WordPress will deactivate all plugins automatically when it cannot find the folder.
4. Reload your site. If it loads, rename the folder back to plugins.
5. Then rename individual plugin folders inside plugins/ one at a time to isolate the bad plugin.

Using WP-CLI to Deactivate All Plugins

If you have SSH access to your server, WP-CLI offers the fastest method:

wp plugin deactivate --all

Once you have identified the faulty plugin, you can reactivate the rest with wp plugin activate --all and then leave the offending plugin deactivated until its developer releases a fix.

Step 3 — Switch to a Default WordPress Theme

If disabling plugins did not resolve the issue, your active theme may be responsible. Switching to a default WordPress theme (such as Twenty Twenty-Four) will rule out theme-related causes.

Via the WordPress Admin

1. Go to Appearance > Themes.
2. Hover over a default theme and click Activate.
3. Reload your site to check whether the white screen is gone.

Via FTP When Admin Is Inaccessible

1. Connect to your server via FTP.
2. Navigate to wp-content/themes/.
3. Rename your current theme's folder (e.g., rename mytheme to mytheme_old).
4. WordPress will automatically fall back to a default theme if it cannot find the active one.
5. Reload your site to verify the fix.

If the site loads after switching themes, the problem lies in your theme's code — typically in functions.php. Open that file in a text editor and review any recent changes for syntax errors such as missing semicolons, unclosed brackets, or mismatched quotes.

Step 4 — Increase the PHP Memory Limit

WordPress requires adequate PHP memory to function. If your server's memory limit is too low, the script can fail mid-execution and produce a white screen. The recommended minimum is 64 MB, with 256 MB or higher preferred for sites running multiple plugins.

Method 1 — Edit wp-config.php

Add the following line to your wp-config.php file, just above the /* That's all, stop editing! */ comment:

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

Method 2 — Edit php.ini

If you have access to your server's php.ini file, locate the memory_limit directive and update it:

memory_limit = 256M

Method 3 — Edit .htaccess

On Apache servers, you can add the following line to your .htaccess file in the WordPress root directory:

php_value memory_limit 256M

After making any of these changes, save the file and reload your website. If a memory limit was the root cause, your site should now load correctly.

Step 5 — Reinstall WordPress Core Files

If none of the above steps resolve the white screen of death, a corrupted WordPress core file may be to blame. Reinstalling the core files replaces any damaged files without affecting your content, themes, plugins, or settings.

Via the WordPress Admin

1. Log in to your WordPress dashboard (if accessible).
2. Go to Dashboard > Updates.
3. Click the Re-install Now button.

Via WP-CLI

If you have SSH access, you can reinstall core files in seconds with a single command:

wp core download --force

The --force flag overwrites existing core files with a fresh copy from the official WordPress repository, leaving your wp-content folder and wp-config.php completely untouched.

Via Manual FTP Upload

1. Download the latest version of WordPress from wordpress.org/download.
2. Extract the ZIP file on your computer.
3. Delete the wp-content folder from the extracted files — you must not overwrite your live wp-content folder.
4. Upload all remaining files and folders to your server via FTP, choosing to overwrite existing files when prompted.
5. Reload your site.

Step 6 — Additional Checks and Advanced Fixes

If the white screen persists after completing the steps above, consider these additional troubleshooting avenues.

Check Your .htaccess File

A corrupted .htaccess file can cause a blank screen or 500 error. To test this, rename .htaccess to .htaccess_old via FTP. Then go to Settings > Permalinks in your WordPress admin and click Save Changes — this regenerates a clean .htaccess file automatically.

Check PHP Version Compatibility

A plugin or theme may require a newer (or older) version of PHP than the one your server is running. Log in to your hosting control panel and verify your current PHP version. Cross-reference it with the requirements listed in the plugin or theme documentation. Most modern WordPress plugins require PHP 7.4 or higher.

Review Your Hosting Error Logs

Your hosting provider maintains server-level error logs that can reveal errors not captured by WordPress debug mode. Look for these logs in your cPanel's Error Logs section or ask your host for access. Lines containing PHP Fatal error or memory exhausted will point you directly to the problem file.

Test With a Different Browser and Clear Caches

Occasionally what appears to be a white screen is actually a caching issue serving a stale blank page. Clear your browser cache, clear any WordPress caching plugin cache, and flush your server-side cache (Varnish, Redis, or your host's built-in cache) before assuming there is a code-level problem.

Contact Your Hosting Provider

If you have exhausted all options, your hosting provider's support team can review server logs with root-level access and identify infrastructure issues such as resource limits, a misconfigured PHP handler, or a server outage that may be causing the white screen.

Resolving the WordPress white screen of death is usually a methodical process: enable debug mode, isolate the faulty plugin or theme, restore adequate memory, and reinstall core files if needed. By working through each step systematically, you can identify and fix the root cause without losing any content or data.

If you want a faster, more hands-off way to manage WordPress issues like this in the future, WP AI Agent is a powerful tool that lets you handle WordPress tasks — including troubleshooting errors, managing plugins, and updating configurations — through simple natural-language AI chat, so you never have to dig through files manually again.

Frequently Asked Questions

Why is my WordPress site showing a white screen with no error message?

WordPress displays a blank white screen when a fatal PHP error occurs and error reporting is turned off. The server suppresses the error output to prevent exposing sensitive information. Enabling WP_DEBUG in your wp-config.php file forces WordPress to display the actual error message so you can diagnose the problem.

Can the WordPress white screen of death delete my content?

No. The white screen of death is a display error caused by a PHP or configuration problem — it does not affect your database or uploaded files. Your posts, pages, images, and settings remain completely intact. Once you fix the underlying error, your content will reappear exactly as it was.

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

If your WordPress admin dashboard is inaccessible, use FTP or your hosting control panel's file manager to rename the wp-content/plugins folder (to disable all plugins), switch your theme by renaming its folder inside wp-content/themes, and add debug constants to wp-config.php. WP-CLI via SSH is also a fast alternative for running diagnostic and repair commands directly on the server.

How long does it take to fix the WordPress white screen of death?

In most cases, the fix takes between 5 and 30 minutes. Deactivating plugins or switching a theme resolves the majority of white screen issues in under 10 minutes. More complex causes such as corrupted core files or server-level configuration issues can take longer, especially if you need to contact your hosting provider for log access.