Conquering The Dreaded White Screen of Death (WordPress)
The scenario: You upgrade WordPress to 3.5.1. All looks fine. You think nothing of it, log out and carry on your day. You try to log into your WordPress site the next day and you see a blank white page. No admin area, no nothing.
You go to the front end of your website, and see the same. The dreaded white screen of death. ARGH!
This happens from time to time, and the best thing to do is stay calm, and just keep Google-ing your errors and reading a lot of forums until you get your fix. You’ll get there, it’s just perseverance.
When it happened to a client of ours, the dastardly cause was a failed upgrade to WordPress 3.5.1. The upgrade was done through the WordPress admin area. Sometimes failed upgrades can happen if a file corrupts during the upgrade, or fails to properly copy over, or if the connection drops out.
Now it’s time for troubleshooting mode.
- Switch on debug mode (there’s nothing worse than working with a blank webpage that is giving you no errors and no feedback). In your wp_config.php file change define(‘WP_DEBUG, false); to the below, or add the below line if it’s not already there.
- Refresh your admin area and front end website and see what errors are now popping up.
- Google these errors and see what solutions are working for other users (the causes of the blank screen of death are so varied, that it’s best to learn from others experiences).
- Lather, rinse, repeat.
Now, here’s what worked for our client’s particular situation. We had to piece together bits and pieces from other forums, but in after a LOT of investigation, reading and testing, hopefully the below will spare some of you the associated grey hair.
- Complete the first 3 steps above
- Via FTP, open the readme.html file that should be living in the root (along with wp-config.php, etc). Check that the WordPress version in the readme.html file is the same as the one you were trying to upgrade to. NOTE: for security reasons the readme.html file should always be manually deleted following a successful upgrade.
- Download to your local machine the version of WordPress that is showing in the readme.html file above.
- Via FTP (Filezilla or similar), rename your wp-admin and wp-includes folders
- Copy your newly unzipped wp-admin and wp-includes folders over to your site
- Rename your wp-settings.php file
- Copy your newly unzipped wp-settings.php file over to your site
- Check if you can now access your site
- If yes, then hooray! Switch off debug mode (see switching on debug mode instructions above), and enjoy the rest of your day, knowing that you took on the white screen of death and won, my friend.
- If no, then Google any errors that are still appearing and read through the forums for solutions.
Generally the causes are:
- Botched/failed upgrades
- Plugins causing havoc
- Templates causing havoc
Persevere and ye shall be victorious!