Skip to content

Instantly share code, notes, and snippets.

@avantegarde
Last active August 29, 2015 14:23
Show Gist options
  • Save avantegarde/d4532dfcb18f62313799 to your computer and use it in GitHub Desktop.
Save avantegarde/d4532dfcb18f62313799 to your computer and use it in GitHub Desktop.
WordPress unexpectedly displaying a blank/white screen steps.
***Imagine the WordPress site you've been working on is now unexpectedly displaying a blank/white screen. Walk us through the steps you'd take to troubleshoot this problem.***
#1. Assuming that I'm already working on the site, remove previously written code to see if it's the culprit.
#2. Check previously written code for errors. White/blank screen if often the result of a php error.
#3. Check to see if blank/white screen is affecting entire site or single page. (Including logged in/out states)
#3.1 If affecting single page - Check page template for errors/conflicts
#3.2 If affecting whole site - check the themes functions.php file for errors/conflicts
#4. Test on a minumum of one other machine to determine if problem is only happening to a single machine.
#5. Check site caches to see if it's either creating the problem or simply cached the problem at the wrong time.
#6. Consider the hosting situation and see if the memory allocated to the domain is exhausted
#6.1 If memory is exhausted and there is no better solution than to increase it, attempt to increase with WordPress php function or increase on the hosting side.
#7. Enable WordPress debugging function in wp-config.php and check errors for insight
#8. Disable plugins you think might be the culprit
#8.1 if disabling a plugin fixes it - debug plugin for conflicts and errors
#8.2 if disabling all plugins does not fix it - Enable WordPress debug function and see if it sheds any light
#9. If white/blank page still exists, backup the theme folder, make sure a default twenty-*** theme is installed, then either remove or move the theme out of the themes directory. WordPress will fallback on to a default theme.
#9.1 If default theme works - debug theme that was causing issues
#10. If white/blank page still exists after applying a default theme, then re-install core wordpress.
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment