How to Fix WordPress White Screen of Death: Step-by-Step Tutorial

TL;DR: The White Screen of Death in WordPress is most commonly resolved by increasing the PHP memory limit in the wp-config.php file or by disabling plugins via FTP. If these initial steps fail, re-uploading core WordPress files often restores functionality without losing your data.

Understanding the White Screen

The White Screen of Death (WSOD) is a frustrating error where your WordPress site displays a completely blank white page with no error messages. This usually indicates a critical PHP error that has stopped execution. While it looks scary, the issue is rarely permanent data loss. It is typically caused by memory exhaustion, a corrupted plugin, or a broken theme. Before diving into code, always ensure you have a recent backup of your database and files. This safety net allows you to experiment freely without fear of breaking your site permanently.

Step 1: Increase PHP Memory Limit

The most common cause of the WSOD is running out of available PHP memory. WordPress requires a minimum of 64MB, but many complex sites need much more. To fix this, you need to access your server files using an FTP client like FileZilla or through your hosting control panel’s file manager. Navigate to the root directory of your WordPress installation and locate the wp-config.php file. Download this file to your computer, open it in a text editor, and paste the following line of code just above the line that says “That’s all, stop editing! Happy publishing.”

Snippet of wp-config.php showing memory limit code

The code is: define(‘WP_MEMORY_LIMIT’, ‘256M’);. Save the file and upload it back to your server, replacing the existing version. Refresh your website. If the screen loads, the issue was simply insufficient memory.

Step 2: Disable Plugins via FTP

If increasing memory did not work, a plugin conflict is likely the culprit. Even if you cannot access your dashboard, you can disable plugins remotely. Using your FTP client, navigate to the wp-content folder and then the plugins folder. You will see a list of folders, each named after an active plugin. Rename the folder of the most recently installed plugin by adding a number to the end, such as “plugin-name-old”. This forces WordPress to deactivate it. Refresh your site. If it loads, reactivate plugins one by one to identify the specific conflict.

Step 3: Re-upload Core Files

Sometimes core files become corrupted during updates. Download a fresh copy of WordPress from wordpress.org. Extract the zip file on your computer, but do not open the folders inside the main extracted directory. Instead, upload the entire contents of the extracted folder to your server via FTP. Select “Replace existing files” when prompted. This overwrites corrupted system files while leaving your wp-content folder and database untouched, preserving all your posts and settings.

Preventive Tips

To prevent future occurrences, keep your WordPress core, themes, and plugins updated. Avoid using nulled or pirated themes, as they often contain malware or bad code that triggers fatal errors. Regularly monitor your server’s error logs, which can provide specific details about what caused the crash.

FAQ

Q: Will fixing the White Screen of Death delete my content?
A: No, fixing the WSOD does not delete your posts, pages, or media. These are stored in your database, which remains intact during these troubleshooting steps.

If you want to dig deeper, check out our guide on How AI Agents Manage Personal Finance & Scheduling.

Q: What if I cannot access my FTP client?
A: If you cannot access FTP, try using the file manager provided by your web hosting control panel, such as cPanel or Plesk, to edit files and rename plugin folders.

Q: How long does it take to fix the White Screen of Death?
A: Most users can resolve the issue within 15 to 30 minutes by increasing the memory limit or deactivating a problematic plugin.

Related Articles

Comments

Leave a Reply

Your email address will not be published. Required fields are marked *