How to Fix WordPress White Screen of Death: Step-by-Step Tutorial
TL;DR: To fix the WordPress White Screen of Death, immediately enable debug mode to identify the error, then systematically deactivate plugins and switch to a default theme to isolate the conflict. If these steps fail, increase your PHP memory limit or restore a recent backup to revert your site to a working state.
Identify the Immediate Cause
The White Screen of Death (WSOD) is one of the most frustrating errors for WordPress users, but it is rarely irreversible. The first step is to determine if this is a temporary glitch or a deeper configuration issue. Begin by accessing your hosting control panel or using an FTP client to navigate to your site’s root directory. Look for the wp-config.php file, which is critical for troubleshooting. Before making any changes, ensure you have a complete backup of your site. Downloading this file allows you to restore original settings if something goes wrong during the editing process.
If you want to dig deeper, check out our guide on How to Market Your Waitlist: 5 Proven Strategies to Grow Sig.
Enable Debugging Mode
Open wp-config.php in a text editor and locate the line that says define( 'WP_DEBUG', false );. Change false to true. This simple switch will reveal hidden PHP errors that are causing the blank screen. Refresh your homepage; you may now see specific error messages indicating which file or function failed. Common culprits include outdated plugins, incompatible themes, or insufficient server resources. Document these errors before proceeding, as they provide the roadmap for your fix.
Isolate Plugin and Theme Conflicts
If debugging reveals no immediate error, the issue likely stems from a plugin or theme conflict. Access your site via FTP or your host’s file manager and navigate to the wp-content folder. Rename the plugins folder to plugins_old. This action deactivates all plugins instantly. Check your site; if it loads, a plugin was the cause. Rename the folder back to plugins and reactivate them one by one, checking your site after each activation to pinpoint the problematic plugin. Once identified, update or replace it. If the screen remains white, rename your current theme’s folder in wp-content/themes to force WordPress to use the default Twenty Twenty-Four theme. If the site loads, your theme is incompatible with your current PHP version or WordPress update.
Increase PHP Memory Limit
Sometimes, the server runs out of memory during complex operations. Add define( 'WP_MEMORY_LIMIT', '256M' ); to your wp-config.php file. This allocates more resources to WordPress, potentially resolving memory exhaustion issues. If all else fails, restore your site from a backup taken before the error occurred.
FAQ
Q: What is the White Screen of Death?
A: It is a common WordPress error where the entire website displays a blank white page instead of content, usually caused by PHP errors or memory limits.
Q: How do I enable WP_DEBUG?
A: Edit your wp-config.php file and change the line define( ‘WP_DEBUG’, false ); to define( ‘WP_DEBUG’, true ); to display error messages.
Q: Can I fix WSOD without FTP access?
A: Yes, most hosting control panels like cPanel offer a File Manager that allows you to edit files and rename folders directly through your browser.