Have you ever faced the WordPress White Screen of Death?
In the past two months, I have received two troubling messages from website owners. One was a text and the other, a phone call. Both had the same problem: a self hosted WordPress powered website with a white screen.
If you have ever experienced the WordPress white screen of death, you know how alarming it can be. If you are seeing that white screen now, know you are not alone. A quick Google search for WordPress white screen will brings up thousands of results.
Let’s take a close look at common causes of the WordPress white screen and steps you can take to resolve the problem. I will also share two case studies about the websites I mentioned earlier with the troubleshooting steps, causes, and the solutions for each one’s problem.
Common Causes of the WordPress White Screen
Common causes of the dreaded white screen in WordPress include:
According to WordPress.org, “Both PHP errors and database errors can manifest as a white screen, a blank screen with no information, commonly known in the WordPress community as the WordPress White Screen of Death (WSOD).”
Plugin Related Issues That Cause White Screens in WordPress
A plugin may be causing the problem. To quickly determine if a plugin compatibility issue is the cause, remain the plugins folder either by FTP or through cPanel to disable all plugins.
FTP – How to rename the plugins folder:
- Navigate and open your website’s wp-content folder.
- Rename the plugins folder.
In the example above, I used the FTP program, WS_FTP Professional. I right clicked on the plugins folder that brought up a menu of different options. I selected the Rename option.
cPanel – How to rename the plugins folder:
- Log into your website’s cPanel, locate Files and click to open the File Manager folder.
- Next, click the “www” folder.
- On the next screen, locate and open the wp-content folder.
- Finally, locate the plugins folder, right click it and rename it. For example, you could rename it to Xplugins.
If renaming the plugins folder solves the problem of the white screen, you know that it is plugin related. The next steps are to:
- Rename the plugin back to the original name, plugins.
- Log into your WordPress dashboard
- Go to your plugins page
- Disable each plugin one by one and check each time to isolate the plugin that is causing the problem.
Theme Related Issues That Cause White Screens in WordPress
If a plugin incompatibility is not the problem, it may be a theme related issue. The first step is to:
- Log into your WordPress dashboard
- Go to Appearance > Themes
- Activate a different theme to see if this solves the white screen problem.
If you are unable to log into your WordPress dashboard administration area, you can log into cPanel or via FTP and rename your theme folder. To use cPanel:
- Log into cPanel and locate Files and open the File Manager folder.
- Locate and open the “www” folder.
- Next, click the wp-content folder.
- Locate and open the themes folder
- Finally, right click your theme folder and rename it. The default theme will be activated if present.
A failed WordPress auto update can also cause the blank white screen of death. If this is the case, re-upload the WordPress core files manually to see if this solves the problem.
Another example of a failed update happened when I was updating Yoast SEO through the WordPress dashboard. The update appeared to time out and my screen went blank. I renamed the plugin folder via FTP and the website came back up immediately. To fix the problem, I downloaded the plugin from the WordPress Plugin repository and manually uploaded it. The problem was resolved.
Opening up your website to a blank page is alarming. By using the troubleshooting steps above, you should be able to quickly fix the problem. Sometimes you may need to take additional steps to discover and correct the situation.
The following are two actual case studies that I mentioned earlier and how the problems were solved.
Case Study 1: Theme Based Problem
I received a text at 4:40 pm one day that a client’s website was gone. I immediately called the web hosting company to start troubleshooting and ruled out server problems and a potential hacking issue. The next steps were to:
- Disable the plugins. This did not correct the problem.
- Activate a different theme. The new theme corrected the white screen.
Next, I re-enable the theme and checked the website. I then discovered that the home page was the only page of the website that was blank. The problem was theme related.
This site was using the free version of the Responsive Theme by Cyberchimps and had been working fine for almost two years. Contributing factors that may have influenced the situation were:
- An auto WordPress security and maintenance update a few days earlier.
- A theme update 2 days earlier.
Next, I checked the theme’s custom settings. It has the ability to override how WordPress displays the front page of a website by enabling a custom front page. There is a checkbox that was checked to override how WordPress displays the front page. The text for the front page was in the “Content area” of this theme’s custom settings.
- I disabled the theme’s override check mark and the default theme’s home page appeared.
- Then, I enabled a separate “home” page with the home page’s text.
- Next, I set the WordPress Settings > Reading to the current page “home” page.
- Finally, I set that “home” page template to Content/Sidebar.
The website now works as it should.
As for why this theme’s home page at the previous settings suddenly went blank after working fine for nearly two years, I can only make an educated conclusion. It was definitely theme related.
Case Study 2: Plugin Related Problem
The phone rang early one morning. This website owner was alerted that his entire website was blank by a potential client.
The website was launched in late 2013 and was running the Twenty Ten theme. No updates had been made to WordPress, the plugins, or the theme since 2014. The first steps included examining the website to see if it had been hacked. It did not appear that the site had been compromised.
The next steps were to disable the plugins and activate a different theme. Neither corrected the problem.
I noticed that the .htaccess file had been updated recently. I examined the file and discovered a large number of directives. A security plugin had been auto writing to this file to lock out IP addresses that were trying to log into the dashboard.
When I disabled (re-named) the .htaccess file, the website came back up.
I cleaned up the .htaccess file and uploaded it to the server. The website worked as it should.
The WordPress white screen of death can send shivers of panic down one’s spin. By using the troubleshooting steps of disabling plugins, changing themes, and re-installing WordPress, you should be well on your way to solving the mystery.
- Fresh backups of your WordPress installation, theme, and plugins are critical in case something goes wrong.
- Consider a website monitoring program to alert you if a problem arises with your website. One free option is ChangeDetection.com. You can set it to monitor your home page. Whenever there is a change, if it is a text change or white screen, you will receive an email notification.
Over to You
Have you ever experienced a blank white screen in WordPress? Please share your story in the comments below. You may be able to help others with the steps you took to fix the problem.