TL;DR: To fix the WordPress White Screen of Death, enable error reporting to identify the specific PHP fatal error, then disable recently installed plugins or switch to a default theme. If the issue persists, increase your memory limit or restore from a backup.
The WordPress White Screen of Death (WSOD) is one of the most frustrating errors a site owner can encounter. It indicates that a PHP script has failed to execute, resulting in a blank, white page. While terrifying, this error is almost always caused by a plugin conflict, a corrupted theme, or exhausted server memory. By following a systematic troubleshooting process, you can identify the root cause and restore your website to full functionality.
If you want to dig deeper, check out our guide on Heavy Metal Contamination: Is This a Real Problem?.
Step 1: Enable Debugging
The first logical step is to reveal what is hidden. By default, WordPress suppresses error messages for security reasons. To see the actual error, access your site via FTP or your hosting file manager. Locate the wp-config.php file in your root directory. Search for the line that says define('WP_DEBUG', false); and change it to true. Immediately below that line, add define('WP_DEBUG_LOG', true); and define('WP_DEBUG_DISPLAY', false);. Save the file and refresh your site. A debug.log file will be created in the wp-content folder, detailing the exact error.
Step 2: Disable Plugins
Plugin conflicts are the most common cause of the WSOD. Log in to your hosting file manager or FTP client. Navigate to the wp-content directory and rename the plugins folder to plugins_old. This effectively deactivates all plugins without deleting them. Refresh your website. If the white screen disappears, a plugin was the culprit. Rename the folder back to plugins, then rename each plugin folder one by one to isolate the problematic code. Reactivate them one at a time, testing your site after each activation.
Step 3: Switch Themes
If disabling plugins did not resolve the issue, the problem likely lies within your active theme. Corrupted theme files or incompatible code can also cause a white screen. Access the wp-content/themes directory via FTP. Rename your current theme’s folder (e.g., from twentytwentythree to twentytwentythree_old). WordPress will automatically fall back to a default theme, such as Twenty Twenty-One. If your site loads correctly, your theme is broken. You may need to reinstall the theme or check the debug.log for specific theme-related errors.
Step 4: Increase Memory Limit
Sometimes, the server runs out of memory while processing a heavy script. You can increase the PHP memory limit by editing your wp-config.php file again. Add the following line: define('WP_MEMORY_LIMIT', '256M');. This allocates more memory to WordPress processes. If you have access to your php.ini or wp-config.php via your hosting control panel, you can also adjust the memory_limit setting directly in the PHP configuration.
FAQ
Q: What causes the White Screen of Death?
A: It is usually caused by exhausted PHP memory, a plugin conflict, or a corrupted theme file.
Q: Can I fix the WSOD without FTP access?
A: Yes, most hosting control panels like cPanel include a File Manager that allows you to edit files directly.
Q: Will enabling debugging delete
Leave a Reply