How To Create Custom 404 Pages in Joomla

The first step in creating a custom 404 page is to create a new article.

  • Title: Create something that is specific to Error 404 since it may be displayed as your browsers title bar.
  • Alias: Type in a simple alias, such as 404.
  • Category: You can use Uncategorised or create another category.
  • Article Text: Add your 404 image or text, or design it however you'd like. In this example, I made my own funny 404 image.

Step 2: Edit Metadata Options

  • On the same article, look at the right column and click on the "Metadata Options" tab.
  • Select "No index, no follow" to prevent this particular page to be indexed in search engines.
  • Save and Close.

Step 3: Create a Hidden Menu


You can view our tutorial on how to create a Hidden menu here.

  • Menu Item Type - Select your Error 404 Page article.
  • Menu Title - Anything you'd like, such as Error 404 Page.
  • Alias - Type in a simple alias, such as 404.

Make sure this menu is not published in a module position so it is not displayed.

Step 3: Copy the Link


Copy the URL from your menu and store it on a notepad since you will be using this URL in your error.php file.

Step 4: Edit the error.php File


Find your error.php file.Usually it is located in "templates/YourTemplate/system/error.php" or in "templates/YourTemplate/error.php".

If you don't have an error.php file, create it in this folder: templates/YourTemplate/error.php.

Please make sure that you have this security code at the top of the file:

1.defined( '_JEXEC' ) or die( 'Restricted access');

Now we need our 404 page code.

For Joomla 1.5 use this code:

1.if ($this->error->code == '404') { header('Location: /theURLtoYour404Page'); exit; }

For Joomla 2.5 and 3.x use this code:

1.if ($this->error->getCode() == '404') { header('Location: /theURLtoYour404Page'); exit; }

Step 5: Test Your 404

PhilmoreSMS Error Page

Type in a URL such as to be redirected to your custom 404 page.

In this example, I used my 404.jpg file. As you can see, I'm not much of a graphic artist, but it gets the point across.

Congratulations! You now know how to create custom 404 pages.


How to fix it No installation plugin has been enabled - Joomla 3.6

09 September 2016 - 92 Views

Joomla 3.6 is a new


DND Policy - How to Deactivate it

13 August 2016 - 274Views

Guest Level Members

28 July 2016 - 164Views

If you are interested in


How to Run a Successful SMS Marketing Campaign

12 June 2016 - 502 Views

SMS - invest in


Put a background image or color on an article

29 September 2015 - 927Views

How to Fix jquery Issue in joomla

21 July 2015 - 1437Views



How to Fix SMS Counters Issue

21 July 2015 - 1583 Views



Accessing cPanel

07 February 2014 - 1488Views

To access


An Introduction to Branding cPanel for your users

07 February 2014 - 1430Views

How to Create a new


An introduction to reseller access within WHM

07 February 2014 - 2497 Views

What is reseller access


Automated database backup for SPC High Earner

06 February 2014 - 1281Views

SPC high earner comes


Creating MySQL Database and User

22 February 2014 - 1724 Views

Creating a MySQL database


Cron Settings for SMS Scheduling

06 February 2014 - 1581Views

Download Now

09 March 2014 - 3310Views

Here is a PDF version of



05 February 2014 - 5316 Views

To create a


How To Add New User in Joomla Using PHPMyAdmin

15 March 2014 - 1747Views

If you need to create 


How to Choose the Best Web Hosting Provider

07 February 2014 - 1412Views

How to create a cPanel account within WHM

07 February 2014 - 1261 Views

One of the more important


How to Create a Package within WHM

07 February 2014 - 1758Views

To create a