How to Fix Joomla White Screen of Death: Step-by-Step Troubleshooting Guide

The Joomla White Screen of Death (WSOD) is one of the most frustrating issues website owners face. Instead of your website loading normally, you’re greeted with a completely blank page — no error message, no clues, nothing.

But don’t worry — this issue is very common and completely fixable.

In this guide, you’ll learn exactly why it happens and how to fix it step-by-step, even if you’re not a technical expert.

What is Joomla White Screen of Death?

The White Screen of Death in Joomla occurs when your website fails to load due to a PHP error, memory issue, or broken extension, but error reporting is turned off — so you only see a blank screen.

Common Causes of Joomla WSOD

Before fixing, it’s important to understand the root cause:

• PHP errors or fatal errors
• Exhausted PHP memory limit
• Incompatible or broken extension
• Template issues
• Incorrect file permissions
• Joomla update failure
• Server configuration issues

Step-by-Step Guide to Fix Joomla White Screen

Follow these steps one by one

Step 1: Enable Error Reporting

By default, Joomla hides errors. Let’s reveal them.

Option A: From Administrator Panel

• Go to System → Global Configuration
• Set Error Reporting = Maximum

Option B: Via configuration.php

Open configuration.php and update:

public $error_reporting = 'maximum';

Reload your website — now you should see the actual error message.

Step 2: Check PHP Error Logs

If nothing appears, check server logs:

• cPanel → Error Logs
• Or file: /public_html/error_log

Look for:

• Fatal errors
• Missing files
• Plugin conflicts

Step 3: Increase PHP Memory Limit

Low memory is a common cause.

Update php.ini or .htaccess:

memory_limit = 256M

Or in .htaccess:

php_value memory_limit 256M

Step 4: Disable Extensions (Most Common Fix)

A broken plugin/module can break your site.

Method 1: Rename Extension Folder

Go to:

/plugins/
/modules/
/components/

Rename suspicious extensions.

Method 2: Disable via Database

Open phpMyAdmin → #__extensions

Set:

enabled = 0

Step 5: Switch to Default Template

Template issues can cause WSOD.

Via Database:

• Table: #__template_styles
• Set default template to Cassiopeia (Joomla 4/5)

Step 6: Check File Permissions

Incorrect permissions can break execution.

Recommended:

• Folders → 755
• Files → 644

Step 7: Verify Joomla Core Files

Corrupted files can cause blank pages.

Solution:

• Re-upload Joomla core files
• Or use Joomla update → reinstall

Step 8: Check .htaccess File

Sometimes .htaccess causes issues.

Try:

• Rename .htaccess → .htaccess_old
• Reload website

Step 9: Check PHP Version Compatibility

Make sure your PHP version supports your Joomla version.

Example:

• Joomla 5 → PHP 8.1+ recommended

Bonus: Quick Fix Checklist

If you're in a hurry:

• Enable error reporting
• Increase memory
• Disable extensions
• Switch template
• Check logs

Related Post: How to Fix Core Web Vitals Issues in Joomla (Step-by-Step Guide)

How to Prevent White Screen Issues

Prevention is always better

• Always update Joomla & extensions
• Use trusted extensions only
• Take regular backups
• Use staging before updates
• Monitor error logs

Final Thoughts

The Joomla White Screen of Death may look scary, but it’s usually caused by simple issues like extensions, memory limits, or PHP errors.

By following this step-by-step guide, you can quickly identify and fix the problem without breaking your site.