How to Fix WordPress White Screen Fix: Practical Guide

What Causes WordPress White Screen

WordPress white screen occurs when a fatal PHP error stops execution before any output reaches the browser. The server processes the request but fails silently, returning a 200 status code with no content.

Common triggers include PHP memory exhaustion when processing large operations, syntax errors in theme or plugin files, conflicts between incompatible plugins, and corrupted WordPress core files after failed updates.

The error remains invisible because WordPress error display is disabled by default in production environments. Enabling debug mode reveals the underlying PHP error that causes the blank screen.

Enable WordPress Debug Mode

WP_DEBUG_LOG writes errors to wp-content/debug.log without displaying them to visitors. After saving, reproduce the white screen and check debug.log for the exact error message, file path, and line number.

If debug.log shows memory exhaustion errors, proceed to increase PHP memory. If it shows plugin or theme errors, note the file path for targeted troubleshooting.

• define('WP_DEBUG', true);
• define('WP_DEBUG_LOG', true);
• define('WP_DEBUG_DISPLAY', false);
• define('SCRIPT_DEBUG', true);

Increase PHP Memory Limit

WordPress default memory limit is 40MB, which becomes insufficient for sites with many plugins, large media libraries, or complex themes. PHP memory exhaustion typically shows as 'Allowed memory size exhausted' in error logs.

Edit wp-config.php and add this line before 'That's all, stop editing':

define('WP_MEMORY_LIMIT', '256M');

For admin operations, also set: define('WP_MAX_MEMORY_LIMIT', '512M');

Save the file and refresh your site. If the white screen persists, the issue is not memory-related. If it resolves, the previous limit was too low for your site's requirements.

Verify your hosting plan supports the increased limit by checking PHP settings in your hosting control panel or phpinfo(). Some shared hosting plans enforce lower memory caps that override wp-config.php settings.

Deactivate Plugins Without Admin Access

Plugin conflicts cause white screens when incompatible code executes during page load. When admin access is blocked, deactivate all plugins via the database or file system.

Database method: Access your database via phpMyAdmin or command line. In the wp_options table, find the row where option_name is 'active_plugins'. Change option_value to 'a:0:{}' to deactivate all plugins at once.

File system method: Connect via FTP or file manager. Navigate to wp-content/plugins/ and rename the plugins folder to plugins_disabled. WordPress will not find any plugins and will load without them.

After deactivation, attempt to access your admin dashboard. If the white screen clears, the issue was plugin-related. Reactivate plugins one at a time, testing the site after each activation to identify the problematic plugin.

Once identified, leave the problem plugin deactivated and check for updates or support documentation. Many white screen issues are resolved in newer plugin versions.

Switch to Default Theme

Theme errors cause white screens when custom functions or template files contain syntax errors or call undefined functions. Switch to a default WordPress theme to test if your active theme is the cause.

Without admin access, use the database method. In wp_options, find 'template' and 'stylesheet' rows. Change both values to 'twentytwentyfour' (or another default theme installed in wp-content/themes/).

Refresh your site. If the white screen disappears, your theme contains the error. Check the debug.log for the specific file and line number, or contact your theme developer.

If using a child theme, first try switching to the parent theme. Child theme errors often stem from functions.php mistakes or incorrect template overrides.

After resolving the theme issue or switching themes, update the template and stylesheet values back to your preferred theme via the database or through the admin panel if access is restored.

Check Server Error Logs and PHP Version

Server error logs capture PHP fatal errors that WordPress cannot log internally. Access error logs through your hosting control panel, typically in Logs or Error Logs sections.

Look for entries timestamped when the white screen occurred. Common errors include 'Call to undefined function', 'Parse error', and 'Fatal error'. The log provides file paths and line numbers for precise debugging.

Verify your PHP version meets WordPress requirements. WordPress 6.0 and higher require PHP 7.4 or greater. Check your hosting panel for PHP version settings and upgrade if necessary.

After changing PHP versions, test your site. Some older plugins and themes are incompatible with PHP 8.0+ due to deprecated functions. If the white screen appears after a PHP upgrade, temporarily revert to the previous version and update your theme and plugins before trying again.

If server logs show file permission errors, reset WordPress file permissions: 644 for files, 755 for directories. Use your FTP client's recursive permission change feature or run commands via SSH if available.

Reinstall WordPress Core Files

Corrupted core files can cause white screens after failed updates or improper file transfers. Reinstalling WordPress overwrites potentially damaged files without affecting your content or settings.

Before reinstalling, backup your wp-config.php file and wp-content directory. These contain your database credentials, plugins, themes, and uploads.

Download the latest WordPress version from wordpress.org. Extract the archive and delete the wp-content folder and wp-config-sample.php from the extracted files.

Upload the remaining files to your server via FTP, overwriting existing files. This replaces wp-admin and wp-includes directories plus root files without touching your configuration or content.

After upload, visit your site. If the white screen persists, the issue is not in WordPress core files. Check plugin and theme code, or review database integrity using tools like WP-CLI or phpMyAdmin.