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.php
file: 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-content
folder and rename theplugins
folder to something likeplugins_old
. - Check your site: If it loads, the issue is with one of your plugins.
- Rename the folder back to
plugins
and rename each plugin folder inside theplugins
directory 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/themes
and rename your active theme’s folder to something liketheme_old
. - WordPress will revert to a default theme like
twentytwentyone
if 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.php
file 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.log
file in thewp-content
folder 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-content
folder andwp-config.php
file).
Step 6: Increase PHP Text Processing Capability
- Create a
.user.ini
file 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
644
and directories to755
.
Step 8: Reinstall WordPress
If all else fails, reinstalling WordPress might be necessary.
- Backup your
wp-content
folder andwp-config.php
file. - Delete all WordPress files except the
wp-content
folder andwp-config.php
file. - Download a fresh copy of WordPress and upload it to your server.
- Restore your
wp-content
folder andwp-config.php
file.
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.