Encountering the WordPress White Screen of Death (WSOD) can be a daunting experience, but don’t worry—it’s a common issue that can be resolved with some troubleshooting. Here’s a comprehensive guide to help you get your site back up and running.
Step 1: Increase the Memory Limit
One of the most common causes of the WSOD is an exhausted memory limit.
- Access your
wp-config.phpfile: You can do this via FTP or your hosting control panel. - Add the following code just before the line that says
/* That's all, stop editing! Happy blogging. */:php
define('WP_MEMORY_LIMIT', '256M');
- Save the file and check your site.
Step 2: Disable All Plugins
Plugin conflicts can also cause the WSOD.
- Access your WordPress files via FTP or your hosting control panel.
- Navigate to the
wp-contentfolder and rename thepluginsfolder to something likeplugins_old. - Check your site: If it loads, the issue is with one of your plugins.
- Rename the folder back to
pluginsand rename each plugin folder inside thepluginsdirectory one by one to identify the culprit.
Step 3: Switch to a Default Theme
A problematic theme can be the cause.
- Access your WordPress files via FTP or your hosting control panel.
- Navigate to
wp-content/themesand rename your active theme’s folder to something liketheme_old. - WordPress will revert to a default theme like
twentytwentyoneif it’s available. Check if the issue is resolved.
Step 4: Enable Debug Mode
Enabling debug mode can help you pinpoint the issue.
- Access your
wp-config.phpfile via FTP or your hosting control panel. - Add or modify these lines:
define('WP_DEBUG', true);
define('WP_DEBUG_LOG', true);
define('WP_DEBUG_DISPLAY', false);
- Check the
debug.logfile in thewp-contentfolder for errors and warnings.
Step 5: Check for Corrupted Core Files
Sometimes core WordPress files can become corrupted.
- Download a fresh copy of WordPress from wordpress.org.
- Extract the files and upload them to your WordPress installation via FTP, overwriting the existing files (except for the
wp-contentfolder andwp-config.phpfile).
Step 6: Increase PHP Text Processing Capability
- Create a
.user.inifile in your WordPress root directory. - Add the following line to the file:
php.ini
max_input_vars = 3000
Step 7: Check File Permissions
Incorrect file permissions can also lead to the WSOD.
- Ensure your WordPress files and directories have the correct permissions: Files should be set to
644and directories to755.
Step 8: Reinstall WordPress
If all else fails, reinstalling WordPress might be necessary.
- Backup your
wp-contentfolder andwp-config.phpfile. - Delete all WordPress files except the
wp-contentfolder andwp-config.phpfile. - Download a fresh copy of WordPress and upload it to your server.
- Restore your
wp-contentfolder andwp-config.phpfile.
Step 9: Contact Your Hosting Provider
If you’re still experiencing issues, it may be time to contact your hosting provider. They can help identify server-related problems that might be causing the WSOD.
By following these steps, you should be able to resolve the WordPress White Screen of Death and get your site back online. If you have any questions or need further assistance, feel free to leave a comment below.
Abhishek Bhandari, Full Stack Developer and Entrepreneur
An informative and well-written piece. The principles are easily understood and applied thanks to your thorough explanations and practical examples. Thank you for taking the time to provide such detailed information. Your time and knowledge are much appreciated.