← All errors

Joomla White Screen of Death (Blank Page): How to Fix

Symptoms: Completely blank white page, front end or admin · No error message or clue shown · Often appears right after an update or installing an extension

Mostly verified — work on a backup/staging copy. Steps are corroborated by Joomlashack, the official forum and docs (researched 2026-06-01). The error reporting techniques are diagnostic — they reveal the hidden error rather than fixing it directly.

✅ Verified on a live Joomla 5.4.6 (PHP 8.2) install: the configuration.php $error_reporting key exists (ships as 'default'; set to 'development' or 'maximum' to surface errors).

The White Screen of Death (WSOD) is a completely blank white page with no error text. Because Joomla (and PHP) suppress the message by default, the first job is to make the real error visible.

Step 1 — Force errors to display

If you can still reach the back end: Go to System → Global Configuration → Server → Error Reporting and set it to Maximum. Or edit configuration.php and set:

public $error_reporting = 'development';

If the back end is also blank, edit index.php over FTP and add this right after the opening line:

ini_set('display_errors', TRUE);
error_reporting(E_ALL);

Or set in php.ini:

display_errors = On
error_reporting = E_ALL & ~E_NOTICE & ~E_STRICT

Caveat: if the fatal error happens before index.php runs, even this may not print anything — in that case check your host’s PHP error log.

Step 2 — Read the error, then fix the cause

Once the real message appears, it usually points at one of these:

A faulty extension

Disable a suspect extension over FTP by renaming its folder, e.g. /components/com_sh404SEF/ → /components/com_sh404SEF_disabled/ (also rename the matching folder under /administrator/components/). If the white screen clears, you’ve found the culprit.

Corrupted core files

Reinstall the Joomla core. Prefer the back-end “Reinstall core files” feature plus Extensions → Manage → Database → Fix, because a raw FTP overwrite of files does not apply needed database changes.

joomla white screen after update · joomla white screen of death · joomla blank page fix · joomla admin white screen

Sources