How to Fix WordPress White Screen of Death

Disclosure: This post contains affiliate links, which means I may earn a commission if you click through and make a purchase. This comes at no extra cost to you, and it helps support the ongoing work at HostBeacons. I only recommend products and services I genuinely trust.

You open your WordPress site and instead of your beautiful homepage, you get a blank white screen. No error message. No clue what went wrong. Just an empty, soul-crushing void staring back at you.

If that sounds familiar, you have just encountered the WordPress White Screen of Death, often shortened to WSoD. It is one of the most common and most frustrating WordPress errors out there. I have dealt with it more times than I can count, on my own sites and on client sites alike. The good news is that it is almost always fixable, and you do not need to be a developer to sort it out.

In this guide, I am going to walk you through every step I use to diagnose and fix the White Screen of Death. We will start with the quickest checks and work our way through more involved fixes. By the end, you will know exactly what to do the next time your site decides to go blank on you.

What Causes the WordPress White Screen of Death?

Before we start fixing things, it helps to understand what is actually happening. The White Screen of Death is usually caused by a PHP fatal error or a memory limit issue that prevents WordPress from rendering your page. Instead of showing you a broken page, WordPress essentially gives up and shows nothing at all.

The most common culprits include:

A plugin conflict or a broken plugin update
A theme that contains a PHP error
Exhausted PHP memory limit
A corrupted .htaccess file
Corrupted WordPress core files
A database connection issue (which I cover in detail in my guide on how to fix the “Error Establishing a Database Connection”)

Now let us get to work.

Step 1: Enable WordPress Debug Mode

The first thing I always do is turn on debug mode. A blank screen tells you nothing, but WordPress debug mode forces PHP to display the actual error, which points you straight to the problem.

To enable it, you need to edit your wp-config.php file. This file sits in the root directory of your WordPress installation. You can access it through your hosting file manager or via FTP using a client like FileZilla.

Find the line that says:

define( 'WP_DEBUG', false );

Replace it with the following:

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

Save the file and reload your site. If there is a PHP error causing the white screen, you should now see it displayed on the page. The error message will typically tell you exactly which file and which line number is responsible. That alone is often enough to identify whether a plugin or theme is the source of the trouble.

Even if the error does not appear on screen, check the debug log file at wp-content/debug.log for recorded errors.

Once you have fixed the issue, remember to set WP_DEBUG back to false on a production site. You do not want error details visible to your visitors.

Step 2: Increase the PHP Memory Limit

If the error message mentions something about memory exhaustion, or if debug mode still shows a blank screen, you may be running out of PHP memory. WordPress and its plugins need a certain amount of memory to operate. When that limit is exceeded, the site crashes.

Open wp-config.php again and add this line just before the comment that says “That’s all, stop editing!”:

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

If you want to also increase the memory limit for admin tasks, add:

define( 'WP_MAX_MEMORY_LIMIT', '512M' );

Save the file and check your site. If the white screen disappears, you found the problem. However, keep in mind that this is sometimes a band-aid rather than a true fix. If a plugin is consuming an unreasonable amount of memory, you should investigate which one it is and consider replacing it.

It is also worth noting that your hosting provider sets a server-level PHP memory limit. If your host caps memory at 128M, the wp-config.php change alone may not help. In that case, you might need to contact your host or consider upgrading to a plan with better resources. I keep a regularly updated list of the best WordPress hosting providers if you are shopping around.

Step 3: Disable All Plugins via FTP

Plugins are the number one cause of the White Screen of Death. A bad update, a compatibility conflict, or a poorly coded plugin can bring your entire site down in an instant.

If you cannot access your WordPress dashboard, which is often the case with WSoD, you can disable plugins manually through FTP or your hosting file manager.

Navigate to the wp-content directory. You will see a folder called plugins. Rename it to something like plugins-disabled. This effectively deactivates every plugin on your site because WordPress can no longer find them.

Now reload your site. If the white screen is gone, you know a plugin was responsible. The next step is to figure out which one.

Rename the folder back to plugins. Then go inside the folder and rename each individual plugin folder one at a time, reloading your site after each rename. When the white screen returns, you have found your culprit. Remove or replace that plugin and move on with your life.

Step 4: Switch to a Default Theme

If disabling plugins did not fix the issue, the problem may be with your theme. Themes can contain PHP errors just like plugins, especially after an update or a manual code edit.

Using FTP or your file manager, navigate to wp-content/themes. Rename your active theme’s folder to something else, like yourtheme-disabled. WordPress will automatically fall back to a default theme such as Twenty Twenty-Five if it is installed.

If your site loads after doing this, the theme is the problem. You can contact the theme developer, check for a newer version, or restore a backup from before the issue started. Speaking of which, if you do not have a backup system in place, now is a good time to read my guide on how to back up your website. Trust me, future you will be grateful.

If no default theme is installed, you can download one from wordpress.org and upload it to the wp-content/themes directory via FTP.

Step 5: Clear All Caches

Caching is wonderful for performance, but it can occasionally serve a stale or broken version of your site even after the underlying problem has been fixed. If you have made changes and the white screen persists, caching might be the reason.

There are several layers of cache to consider:

Browser cache: Do a hard refresh (Ctrl+Shift+R on Windows, Cmd+Shift+R on Mac) or try loading the site in an incognito window.
Plugin cache: If you are using a caching plugin like WP Super Cache or W3 Total Cache, navigate to wp-content/cache via FTP and delete the contents of that folder.
Server-side cache: Some hosting providers run their own caching layer. Log into your hosting control panel and look for an option to purge or flush the cache.
CDN cache: If you use a CDN like Cloudflare, purge the cache from your CDN dashboard as well.

After clearing everything, reload your site fresh.

Step 6: Check and Reset Your .htaccess File

The .htaccess file controls how your server handles URL routing and other directives. A corrupted .htaccess file can cause the white screen or a variety of other odd behaviors.

Using FTP, navigate to your WordPress root directory and find the .htaccess file. Rename it to .htaccess-backup. Then reload your site.

If the white screen goes away, the file was the issue. You can generate a fresh one by logging into your WordPress dashboard, going to Settings, then Permalinks, and simply clicking Save Changes without changing anything. WordPress will create a new, clean .htaccess file for you.

If you had any custom rules in the old file (for redirects, security headers, and so on), you will need to add those back manually after the new file is generated.

Step 7: Reinstall WordPress Core Files

If nothing else has worked, your WordPress core files may be corrupted. This is less common but it does happen, particularly after a failed auto-update or a security compromise.

Do not panic. Reinstalling core files does not delete your content, themes, or plugins. It only replaces the core WordPress system files.

Download a fresh copy of WordPress from wordpress.org. Extract the zip file on your computer. Using FTP, upload the wp-admin and wp-includes folders from the fresh download to your server, overwriting the existing ones.

Do not overwrite the wp-content folder, as that contains your themes, plugins, and uploads. Also leave wp-config.php alone since it contains your site’s configuration.

After the upload completes, reload your site. If corrupted core files were the problem, this should fix it.

What If None of These Steps Work?

In rare cases, the White Screen of Death may be caused by a server-side issue that is outside your control. Your hosting provider’s PHP version might have been updated in a way that breaks compatibility, or there could be a server misconfiguration.

If you have tried everything above and you are still stuck, contact your hosting provider’s support team. Give them the details of what you have already tried. Good hosts will be able to check server logs and identify the issue from their end. If your current host is unhelpful or if this kind of thing keeps happening, it may be time to consider switching to one of the more reliable WordPress hosting providers out there.

Preventing the White Screen of Death

Once you have your site back up and running, it is worth taking some steps to prevent this from happening again. Here is what I recommend:

Keep regular backups. I cannot stress this enough. Automated daily backups give you a safety net that makes any disaster recoverable. Check out my guide on how to back up your website if you have not set this up yet.
Update one thing at a time. When updating plugins and themes, do them one at a time rather than all at once. That way, if something breaks, you know exactly which update caused it.
Use a staging environment. Many good hosts offer staging sites where you can test updates before applying them to your live site. Use it.
Stick to reputable plugins and themes. Avoid plugins that have not been updated in years or have poor reviews. The WordPress plugin repository shows when a plugin was last updated and whether it has been tested with recent versions of WordPress.
Monitor your PHP version. Make sure your plugins and themes are compatible with the PHP version your server is running. PHP 8.x introduced breaking changes that older code may not handle gracefully.
Set up uptime monitoring. Use a free service to ping your site every few minutes. If it goes down, you will know immediately rather than finding out hours later from an unhappy visitor.

Frequently Asked Questions

Can the White Screen of Death affect only part of my site?

Yes. It is possible for the WSoD to affect only the front end while the admin dashboard still works, or vice versa. It can even affect only specific pages. This usually points to a theme issue (if the front end is blank) or a plugin conflict (if specific functionality is broken). The troubleshooting steps above still apply — start with debug mode and work your way through the list.

Will I lose my content if I reinstall WordPress core files?

No. Reinstalling core files only replaces the wp-admin and wp-includes directories. Your posts, pages, media, themes, plugins, and database are all untouched. That said, you should always have a backup before making any changes to your site’s files. Better safe than sorry.

How is the White Screen of Death different from a database connection error?

The White Screen of Death typically shows a completely blank page, while a database connection error usually displays a specific message saying “Error establishing a database connection.” The causes and fixes are different. If you are seeing that database error message, head over to my guide on how to fix the Error Establishing a Database Connection for targeted help.

Does the White Screen of Death mean my site has been hacked?

Not necessarily. While a security breach can corrupt files and cause a white screen, the vast majority of WSoD cases are caused by plugin conflicts, theme errors, or memory limits. If you suspect a hack, look for unfamiliar files in your WordPress directories, check for unauthorized admin accounts, and run a security scan after you get the site back online.

How long does it take to fix the White Screen of Death?

In most cases, you can resolve it within 15 to 30 minutes by following the steps in this guide. The fastest fix is usually disabling plugins, which takes just a couple of minutes. Reinstalling core files takes longer because of the file upload process, but even that rarely exceeds an hour.

Wrapping Up

The WordPress White Screen of Death looks terrifying, but it is almost always a straightforward fix once you know where to look. Start with debug mode to get the actual error message. Check your plugins, then your theme. Clear your caches, inspect your .htaccess file, and if all else fails, reinstall the core files.

The most important takeaway from all of this is to keep backups. Every single one of these steps becomes less stressful when you know you can restore a working version of your site at any time. Set up automated backups today if you have not already.

If you have questions or ran into a situation not covered here, feel free to drop a comment below. I have seen just about every variation of this error over the years and I am happy to help you troubleshoot.