Skip to content


Switch branches/tags

Name already in use

A tag already exists with the provided branch name. Many Git commands accept both tag and branch names, so creating this branch may cause unexpected behavior. Are you sure you want to create this branch?

Latest commit


Git stats


Failed to load latest commit information.
Latest commit message
Commit time
January 12, 2015 15:43
August 11, 2015 09:31


This plugin helps troubleshoot issues with the infamous WordPress WSOD (White Screen of Death). Most errors can be caught with WP-DEBUG turned on using tools like X-Debug, but some of the fatal errors don't come through either with WP-DEBUG or your PHP error handler. This is because PHP lets WP "handle" the error - the way WP handles an fatal error is to not display it [to increase security, since error messages often reveal information that can be used to leverage an attack on a site]

Plugin developers and advanced users who troubleshoot complex issues will find this tool handy. No more messing with your PHP configuration or blind-testing to find out what's going on!


  • Open up the /mu-plugins folder in your WordPress Directory (or create one) usually located within /wp-content folder in your /public_html folder. Select the PHP file no-white-screen.php and place it into the /wp-content/mu-plugins folder in your WordPress Directory. You will have all errors displayed or wrriten to log depending on your settings in the next step.

  • Open the wp-config.php file in your root Wordpress installation and make these changes

   // Comment this out or change to true 
   // define('WP_DEBUG', false);

   define('WP_DEBUG', true);
   // If you want to write to log
   define('WP_DEBUG_LOG', true);

   // If you want to hide errors from users (Used mostly for live sites)
   define('WP_DEBUG_DISPLAY', false);

   // Just in case
   @ini_set('display_errors', 0);

Further Reading


If you still don't see any errors, then it's likely that there's something fundamentally wrong with WordPress. You should start debugging /wp-settings.php by adding breakpoints and identifying the last execution point(or line).

IMPORTANT Remember to remove this file again after debugging the error! Leaving it will cost your server valuable performance and can also expose error information to the public, which decreases your site's security.


Got a white-screen-of-death in WordPress? Use this file to display the error!







No releases published


No packages published