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
Secure Your Joomla Site Before It’s Too Late
If your website is still on Joomla 3 or Joomla 4, we can help you migrate safely to Joomla 5 or Joomla 6 without losing design, content, or SEO rankings.
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
Need Help With Your Joomla Website?
If you’re planning to build a new Joomla website or improve an existing one, working with experienced Joomla specialists can make a major difference.
Our team helps businesses with:
- Custom Joomla website development
- Joomla upgrades and migrations
- Performance optimization
- Ongoing Joomla support and maintenance
Schedule a Free Consultation Today
to discuss your Joomla project and discover how we can build a powerful website tailored to your business needs.
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.
