Fixing the Joomla White Screen of Death

Joomla White Screen of Death

Sometimes you may change some code on your site or even install an extension, and then you refresh your website and all you see is a blank white screen.

In this tutorial, we're going to show you how to recover from the White Screen of Death (WSOD).

We'll show you how to find the error that's causing your WSOD, and we'll show you how to fix it.

The first thing we need to do is find the error. Here are 4 options for finding that fatal error.


Option #1. Change Error Reporting to Maximum

set error reporting to maximum

  • Try to log into your Joomla administrator area.
  • If you can get in, go to Global Configuration > Server > Error Reporting and set it to Maximum. You can find a more detailed tutorial for this here.
  • Now check the front of your site to see if any errors are displaying.
  • If you can't access your site's administrator area, set this in your configuration.php file:

public $error_reporting = 'development';


Option #2. Edit Files in FTP

  • Log in to your Joomla site files via FTP.
  • Find your index.php file located in the root of your site.
  • Open the index.php and add this code directly after the very first line of the file:

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


Option #3. Edit PHP.ini file

The PHP.ini file is a vitally important file that controls many of your server's settings. If you don't know where it is, use this tutorial to find it.

We recommend that you change these two settings:

  • Set Display error to On:

display_errors = On

  • Set error reporting:

error_reporting = E_ALL & ~E_NOTICE & ~E_STRICT


Option #4. Check Your Server Log

  • Check your server error log for any indication of what is causing the issue.

Check your Joomla server log

If you are not sure how to access this, you can contact your hosting company.

If you are on localhost, you can usually find it in a directory called "logs" within the installation folder of your local server.

You've found the error message. Now what?

When you have discovered what is causing the error message, it's time to analyze it. You will hopefully see errors that resemble those in the image below.

Even if you don't understand the message, you know which extension is causing problems

In these examples, the errors come from sh404SEF and from Xmap. Even if you don't understand the message, you know which extension is causing problems.

If the name of an extension can't be found, you might see an error message like the ones below. This may mean that there's a problem with the Joomla core files.

What can you do now that you've identified the troublesome extension?

What can you do now that you've identified the troublesome extension?


Problems with an extension? Disable the extension

This tutorial shows how to disable a plugin, but applies to other types of extensions also.

The quickest and easiest solution is to log in to your site via FTP.

If the troublesome extension is a component, go to the /components/ folder and change the name of the extension folder.

For example, change /com_sh404SEF/ to /com_sh404SEF_disabled/.

You may also need to change the directory name within the component in the /administrator/components/ directory as well.

Problems with the Joomla core? Reupload the core files

If you didn't install any extensions and you think it may be caused by the core Joomla files, try reinstalling all of Joomla core files.

You can do this by downloading the latest version found on joomla.org and overwriting all the directories to your servers FTP.

If you have access to the administrator area, you can also try Step 5 from this tutorial.


Still stuck? It's time to ask for help ...

If you still can not fix the white screen of death with solutions above, it's probably time to call in outside help:

  • You can become a Joomlashack member and ask us for help.
  • You can contact the developer of this extension that is causing issues to see if there has been a recent bug fix or that it is a known issue.
  • You can search Google for the error message and see if anyone has a fix.
  • You can ask on the Joomla.org forums.
  • You can ask or hire a professional developer for help.

Additional Reading

What's Next?

Save $1,000's when you sign up to Joomlashack's Everything Club.

You will get access to all our 32 extensions, and legendary support!

  Click here to join the Everything Club