Skip to content

WordPress White Screen: How to Get Your Site Back Online

Medium 20 min Updated:

Quick answer

The White Screen of Death means a PHP script crashes before outputting anything, and the error is hidden. Enable error display in `wp-config.php`, read the message, then disable plugins and switch the theme to the default one. In most cases the culprit is an incompatible plugin, theme, or insufficient PHP memory.

How to recognize the problem

  • The site and admin show a completely blank white page
  • Logging in to `/wp-admin` does not show the login form
  • The page loads but there is no content or error message
  • The browser shows status 500 or 200 with an empty response body
  • After updating a plugin or theme, the site stopped opening

Most common causes

Fatal PHP error

A plugin or theme calls a function that does not exist or is incompatible with the PHP version, so execution stops before the page is output.

Insufficient PHP memory

When PHP reaches `memory_limit`, the script terminates without a message, and the browser shows a blank page.

Broken theme after update

A partially updated or incompatible theme crashes on load, affecting both the front end and admin.

Corrupted core files

An interrupted WordPress update or failed file transfer leaves incomplete PHP files.

Hosting-level conflict

Changing the PHP version or disabling a required module (for example `mbstring`) causes a crash without a visible message.

Step-by-step fix

  1. 1

    Make a backup first

    Before any changes, download a copy of the files and database via the hosting panel or a backup plugin. If you cannot access the admin, download the files via SFTP and the database via phpMyAdmin or the backup tool in cPanel. This ensures you can return to the previous state if something goes wrong.

  2. 2

    Enable error display

    Open wp-config.php via SFTP or the file manager and temporarily set define( 'WP_DEBUG', true ); and define( 'WP_DEBUG_DISPLAY', true );. Refresh the site and read the message that now appears. If the error still does not show, enable display_errors in php.ini or via the hosting panel.

  3. 3

    Check the error log

    If error display is disabled at the server level, check error_log in the site root or in the hosting panel (logs section). The last lines usually name the file and line where execution stopped. That information is the fastest way to the culprit.

  4. 4

    Disable plugins without admin access

    Via SFTP, rename the wp-content/plugins folder to plugins-off. If the site comes back, the problem is in a plugin. Then restore the folder name and rename individual plugin folders one by one until you find the one crashing the site.

  5. 5

    Switch to the default theme

    Rename the active theme folder in wp-content/themes, for example to theme-off. WordPress then automatically switches to the default theme if it is installed. If the site comes back, update the theme or replace it with a compatible version.

  6. 6

    Increase PHP memory

    In wp-config.php, add define( 'WP_MEMORY_LIMIT', '256M' ); and, if the host allows, raise memory_limit in php.ini or in the hosting panel. Also check that the PHP version is supported for your WordPress version.

  7. 7

    Restore core if files are corrupted

    From the admin or via the hosting panel, trigger a core re-download, or manually replace the wp-admin and wp-includes folders and the root files (except wp-config.php and wp-content) with fresh files of the same version. Do not touch the wp-content folder, as it contains themes, plugins, and uploads.

  8. 8

    Disable error display at the end

    When the site works, set WP_DEBUG back to false and remove WP_DEBUG_DISPLAY so visitors do not see internal messages. If you need errors to still be logged, instead of fully disabling, leave WP_DEBUG on, WP_DEBUG_DISPLAY off, and WP_DEBUG_LOG on, so errors are logged to wp-content/debug.log.

If nothing helps

If the white screen persists after disabling all plugins and changing the theme, the problem is most likely below WordPress: incorrect PHP configuration, a missing module, a full disk, or a corrupted database. Check disk usage and quota in the hosting panel, then the PHP version and the list of enabled modules. If the site was in maintenance mode, delete the .maintenance file in the root. If that does not help either, restore a backup with a known working state and then gradually apply updates one by one, checking after each step.

How to prevent it

  • Regularly back up files and the database and test restoration
  • Update plugins and themes on a test copy before production
  • Keep PHP and WordPress on supported versions and monitor `debug.log`
  • Remove inactive plugins and themes you do not use

When to call a professional

If you do not have file access via SFTP, do not have a backup, or the white screen recurs after every change, it is better to call IT support. They can check the server configuration and database without the risk of permanent data loss.

Website development · Fast, SEO-ready, multilingual websites

FAQ

Does a white screen mean the site lost data?

No. The database and files are usually intact, as this is a PHP code execution error. Data can only be lost if risky changes are made without a backup.

Can I fix the site if I cannot log in to the admin?

Yes, via SFTP or the file manager on the hosting. Renaming the plugins and theme folders bypasses the admin and immediately shows if the problem is in them.

Why is the error not visible on screen?

Most hosts disable error display so visitors do not see internal details. That is why the message only appears when you enable `WP_DEBUG` or check `error_log`.

Share
Didn't find a fix?The AI IT assistant is available 24/7. Describe the problem or send a screenshot of the error and get instructions for your case.Ask the AI IT assistant