The “white screen of death” has long been one of the most common pain points for WordPress designers and developers. You add a new plugin or make a change to a theme file, and all of a sudden – disaster. Your site is now only displaying a white screen. Refreshing the page does nothing, and you can’t even access your login page.
This issue can indicate a number of problems, which we’ll address in a moment. First though, it’s important to note that this error can manifest itself differently in different browsers. Currently, when this issue occurs, Safari and Firefox will display the infamous white screen. Chrome however, as of late 2015, will display a 500 error. This is important to note, as both scenarios will require the same troubleshooting methods.
A white screen or 500 error occurs when PHP returns a fatal error. A PHP fatal error can have many sources, but they’re typically related to the following issues:
When PHP returns an error, they’re hidden by default from the website user. WordPress uses a PHP constant in the wp-config.php file to change that and make PHP errors visible on the site. This setting is called WP_DEBUG. You can toggle WP_DEBUG on and off on any site on Flywheel from the ‘Advanced’ tab.
Once you’ve enabled WP_DEBUG, all PHP errors, notices, and warnings will be displayed directly on the page for you to investigate. It’s worth noting that only fatal PHP errors will cause a whitescreen or 500 error. You may see many other PHP notices and warnings displayed, but those are likely just messages for plugin and theme developers and don’t typically point to an immediate issue. The error below is a PHP fatal error that would be thrown if there is a PHP syntax error in the functions.php file of the Twenty Sixteen theme.
You can use this information to help track down the issue that’s causing your site to display a white screen. Depending on what you discover, you have several options:
Everything you need to know about managing your team with our Organizations feature.8 Articles
Learn everything there is to know about what Blueprints are, how to create them and how to make the best use of them.5 Articles
All there is to know about our free, automatically installed and activated SSL certificates.8 Articles
How to get the most out of Staging, which allows you to duplicate a site, make changes, and then push those changes to the live site.6 Articles
Everything you need to know about our amazing, free local WordPress development software for Mac and PC.5 Articles
Everything you need to know about our Whitelabel subscriptions for branding and reselling Flywheel.4 Articles
Everything you need to know to get your first Flywheel site up and running.8 Articles
The most commonly asked questions, and a few we just think you should know.24 Articles
Questions that don't fit elsewhere, or those about Flywheel in general.56 Articles
Questions relating to payments, billing and managing your account on Flywheel.12 Articles
Details about how to manage DNS and point your domain names at Flywheel.10 Articles
How to access your WordPress database to make changes and update content.3 Articles
Details about everything Flywheel does to makes your site so secure.12 Articles
Which plugins work best, which plugins work worst, and everything in between.7 Articles
Here's a free ebook!