Help articles Frequently Asked

Help! My site is displaying a white screen / 500 error.

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.

browser_whitescreen_031116

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.

browser_500_031116

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:

  • plugin or theme conflicts
  • PHP syntax errors
  • exhausted memory on the server

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.

wpdebug

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.

browser_parseerror_031116

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:

  • If it’s a parse error like above, you can use SFTP to access the file noted in the error, and investigate further.
  • If the error mentions a function and displays a path to a plugin or theme, you can rename or move that plugin/theme folder via SFTP to disable it.
  • If it’s a fatal error noting memory exhaustion, contact [email protected] and let us know which site you’re working on. We can likely adjust your memory limit to address this error.
  • You can also download all of your site’s error logs to further investigate potential issues.

Note

If you’re unsure about any errors you’re seeing after enabling WP_DEBUG, contact us at [email protected] and include the error message and site you’re working on. We’re happy to help!

  • Organizations

    Everything you need to know about managing your team with our Organizations feature.

    8 Articles
  • Blueprints

    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
  • Simple SSL

    All there is to know about our free, automatically installed and activated SSL certificates.

    8 Articles
  • Staging

    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
  • Local by Flywheel

    Everything you need to know about our amazing, free local WordPress development software for Mac and PC.

    5 Articles
  • White Label

    Everything you need to know about our Whitelabel subscriptions for branding and reselling Flywheel.

    4 Articles
  • Getting started

    Everything you need to know to get your first Flywheel site up and running.

    8 Articles
  • Frequently Asked

    The most commonly asked questions, and a few we just think you should know.

    24 Articles
  • General Questions

    Questions that don't fit elsewhere, or those about Flywheel in general.

    56 Articles
  • Billing & Accounts

    Questions relating to payments, billing and managing your account on Flywheel.

    12 Articles
  • Domain Names

    Details about how to manage DNS and point your domain names at Flywheel.

    10 Articles
  • Database

    How to access your WordPress database to make changes and update content.

    3 Articles
  • Security

    Details about everything Flywheel does to makes your site so secure.

    12 Articles
  • Plugins

    Which plugins work best, which plugins work worst, and everything in between.

    7 Articles

Get in touch with us

Standard support hours are M-F 9am-5pm CDT and 24/7 emergency support.

WordPress experts

Try it yourself. It's free & takes less than 60 seconds. Sign up

× How to manage 50+ WordPress Sites

Here's a free ebook!

How to manage 50+ WordPress Sites

Austin Sales Representative
Online

Hey! Austin here!
Can I answer pre-sales questions you have?