WordPress white screen of death is typically compared to Windows’ blue screen of death, i.e. it stops your WordPress blog or website from working and you cannot access the WordPress dashboard. The good thing is that WordPress white screen of death can be easily solved within minutes. In this WordPress tutorial we will explain how you can easily recover from the WordPress white screen of death and regain access to the WordPress dashboard.
Why the WordPress white screen of death?
There are several scenarios which can break down a WordPress installation resulting in the white screen of death. In most cases we’ve seen so far, the white screen of death is not a WordPress problem, but something else, such as a plugin breaking down the WordPress installation. Typically one cannot access the WordPress dashboard because of a white screen of death after:
- Upgrading a plugin
- Adding a new plugin
- Upgrading WordPress to the latest version
- Changing plugin or WordPress source code from the Editor
How to solve WordPress white screen of death
If you remember what was the last change you have done before you encountered the WordPress white screen of death, you can simply connect to your website using an FTP client and revert back the change. E.g. if you changed some of the code from a plugin, or a WordPress core file, using FTP navigate to the directory where such file is and download it to your computer. Revert back the change and upload it back to your website. This should solve the issue.
If you added and enabled a new plugin and now cannot login to the WordPress dashboard because of a WordPress white screen, connect to your website using an FTP client, navigate to the plugins directory (/wp-content/plugins) and delete the plugin directory.
WP White Security.com WordPress Tip: The name of the plugin directory is always the same, or similar to the plugin name. E.g. the plugin Akismet, is installed in the directory /wp-content/plugins/akismet/ directory. By deleting the akismet directory from the /wp-content/plugins/ directory, you are disabling such plugin from WordPress.
Fixing WordPress white screen of death after upgrading WordPress
If you just upgraded your WordPress installation and you cannot login to your WordPress dashboard because of the white screen of death, the issue might be caused by an incompatible plugin or theme. This is a very common scenario since not all plugins are always tested against the latest version of WordPress. To regain access to the WordPress dashboard and find out which is the plugin that is causing the white screen, follow the below step by step procedure:
- Connect to your website using an FTP client
- Download a copy of all the plugins found in /wp-content/plugins/ to your computer
- Delete all the plugins from the plugins directory, e .g. /wp-content/plugins/[plugin]
- After deleting the plugins you should be able to login to the WordPress dashboard (http://www.website.com/wp-admin)
- Upload one of the plugins from the local copy on your computer (the ones you downloaded in step 2 of this procedure)
- Navigate to the Plugins node in the WordPress dashboard and enable the plugin
- If the plugin is enabled successfully, upload another plugin and enable it as well
- Once you enable a plugin and upon enabling it you encounter the infamous WordPress white screen of death, the plugin you just uploaded is causing the white screen of death
- Delete the directory of the plugin which is causing the problem via FTP and you will regain access to the WordPress dashboard
Once you know which is the problematic plugin, don’t upload it again. You can still upload all the other plugins and re-enable them from the WordPress dashboard. Check the online WordPress plugin directory on wordpress.org to see if there is an updated version of the plugin, or advise the plugin’s developer about the issue.
WP White Security.com Webmaster Tip: Before upgrading or doing any changes to your WordPress website or blog, always make a backup of your WordPress installation.
If you have problems with your WordPress installation and still cannot fix them, or still cannot figure out what is causing WordPress to crash, get in touch with us for assistance.