themezinho
Troubleshooting

Fixing the white screen of death (WSOD)

A white screen of death (WSOD) means WordPress encountered a fatal PHP error but isn’t displaying it. Follow these steps in order — most WSODs are resolved within the first two or three steps.

Can’t access WP admin?All the steps below can be done via FTP or cPanel File Manager if your admin panel is also showing a white screen.

Step 1 — Enable WP_DEBUG to see the error

Edit your wp-config.php file (in the WordPress root) and find this line:

define( 'WP_DEBUG', false );

Change it to:

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

Now check /wp-content/debug.log — the error message will tell you exactly what’s wrong (the file name and line number). Fix the issue, then set WP_DEBUG back to false.

Step 2 — Increase the PHP memory limit

A low memory limit is one of the most common WSOD causes. Add this line to wp-config.php just above the “That’s all, stop editing” comment:

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

Reload the page. If it works, your server’s default memory limit was too low. Ask your host to increase the server-level memory_limit in php.ini.

Step 3 — Deactivate all plugins

Via FTP, rename the /wp-content/plugins/ folder to plugins_disabled. Reload the site. If the white screen clears, a plugin is causing it.

To find which one: rename the folder back to plugins, then go to Plugins → Installed Plugins in wp-admin and deactivate all plugins. Re-activate them one by one, refreshing after each, until the white screen reappears. That’s your culprit.

Step 4 — Switch to a default theme

Via FTP, rename the Themezinho theme folder (e.g., themezinho → themezinho_off). WordPress will fall back to its default theme (Twenty Twenty-Four). If the site loads, the theme itself is causing the error — check the debug log for the specific file and line number.

Step 5 — Check for a PHP version mismatch

If a recent theme or plugin update introduced code incompatible with your PHP version, you’ll get a WSOD. Go to Tools → Site Health to check your PHP version. Themezinho requires PHP 8.0+. If you’re on PHP 7.4, upgrade to 8.1 or 8.2 in your hosting control panel.

Step 6 — Check file permissions

Incorrect file permissions can cause PHP to fail silently. Correct permissions are:

  • Files: 644
  • Directories: 755
  • wp-config.php: 600

You can fix these in cPanel File Manager or via FTP (FileZilla: right-click → File Permissions → Recursive).

Support
Support
Customer Support