Search engine ranking:

How to create and install a custom Apache 404 error document, step by step

This article has step-by-step instructions and template code for creating a custom 404 Page Not Found Apache error document for your website. It looks like a long process, but it's not. Like all my How To's, it gives detailed instructions for every step, for someone who's never done that step before.

I did not find the method at cPanel > Error pages to be helpful or useful. It's better to do the creation of this document yourself.

1) Create the file for your error document

In the public_html folder of your website, create a new file called 404.shtml. The name doesn't have to be 404, but the extension should be .shtml if you want to use any of the SSI (Apache Server Side Includes) code in the template code below. It customizes the output for your site and displays the filename that wasn't found.

a) Create the file in FrontPage, Dreamweaver...

You can create 404.shtml in whatever web design software you use. Put it in your top level directory so it will be published to public_html.

b) Or create the file in cPanel

1. Go to cPanel > File Manager.
2. Navigate to public_html.
3. Click on the text of the Create New File link (about halfway down the page).
4. In the file name box, enter 404.shtml.
5. For file type, select Text Document (it's really an HTML document, but if you select that option, it inserts a bunch of text that you'd delete anyway).
6. Click Create. This will create the document.
7. Find 404.shtml in the file list and click on its name (not the icon next to it).
8. In the upper right corner of the screen, click Edit File.
9. Copy the template code below and paste it into the box.
10. Customize the pasted text for your website.
11. Click Save.

2) Use .htaccess to tell Apache to use your new error document instead of the default one

1. In cPanel > File Manager > public_html, find .htaccess
2. Click on its name.
3. In the upper right corner, click Edit File
4. Insert into the file, at any location that is not enclosed in HTML style tags such as <tag></tag>, the following line. The path MUST be a local URL that starts with /. Do not use http://yoursite.com/...:
   
   ErrorDocument 404 /404.shtml
    
5. Click Save.
6. Test your new error document in your browser by trying to go to a page you know doesn't exist.
7. You should see your new error document, and you're done!

Troubleshooting:

• If the variables such as the website name, file name, server name, and port number aren't showing on the page, Apache Server Side Includes might not be enabled. In public_html/.htaccess, at any location that is not enclosed in HTML style tags such as <tag></tag>, add one of these lines. The first one is more secure:
  
  Options +IncludesNOEXEC
  Options +Includes
   
• Questions, comments, assistance in the Forum.

Notes for customization:

• Within an error document, all links and references must be absolute URLs (such as http://yourdomain.com/...), not relative or local ones.
   
• In addition to the server variables I used in the code below, you can use other Server-Variables shown in the gray table in the RewriteCond section of http://httpd.apache.org/docs/1.3/mod/mod_rewrite.html.

Variations:

If your error document doesn't use Apache SSI features, it can have a file extension other than .shtml, such as .html, .htm, .php, whatever you normally use for web pages.

Also, you can put your error document in a folder other than public_html, such as public_html/errordocuments/... In that case, revise your ErrorDocument line to:

ErrorDocument 404 /errordocuments/404.shtml

If you do this and if you don't want Apache SSI enabled for your entire site, you can create an .htaccess file in /errordocuments and move the Options +IncludesNOEXEC line into it so that it only enables SSI for your errordocuments folder.

If you are on Lunarpages shared hosting, Options +Includes appears to be the default setting for the entire site. If you don't use SSI except for error documents, and want to turn SSI off for the rest of your site, you can put the following line in public_html/.htaccess:

Options -Includes

Reference materials:

http://httpd.apache.org/docs/1.3/mod/core.html#errordocument.