How to create custom error pages in cPanel

An error page appears to site visitors whenever there is a problem. This article explains how to make custom error pages for your website using cPanel.Contents Table of

• Creating a custom error page
• Deleting a custom error page
• More Information

Creating a custom error page

Visitors to your web site see an error page whenever an error occurs. For example, if users enter an incorrect URL or are not authorized to access specific directories, they see an error page. Companies often customize error pages by branding them with a corporate image and a link to their home page.

Custom error pages are optional. An error page is always displayed, whether a custom error page exists or not. If an error page has not been customized, Apache displays a default error page.

To create or modify a custom error page, follow these steps:

1. Log in to cPanel.If you do not know how to log in to your cPanel account, please see this article.
2. Open the Error Pages tool:
   • If you are using the Jupiter theme, on the Tools page, in the Advanced section, click Error Pages:
   • If you are using the Paper Lantern theme, in the ADVANCED section of the cPanel home page, click Error Pages:
     
3. Under Step 1, select the domain you want to configure for error pages.
4. Under Step 2, click the error page that you want to customize.
5. Type the HTML that you want to use in the error page. You can use the links above the editor to insert variables into your code for dynamic content. For example, the following HTML code demonstrates how to use a variable in a custom error page:
   <h1>404 Not Found</h1> <p>The requested page, <!–#echo var=”REQUEST_URI” –>, is not available.</p>
6. Click Save. cPanel saves the custom error page.

Deleting a custom error page

When you create a custom error page, cPanel creates a file with the filename format error_number.shtml in the document root of the domain. You can use the cPanel File Manager to delete this file. To do this, follow these steps:

1. Log in to cPanel.If you do not know how to log in to your cPanel account, please see this article.
2. Open the File Manager:
   • If you are using the Jupiter theme, on the Tools page, in the Files section, click File Manager:
   • If you are using the Paper Lantern theme, in the FILES section of the cPanel home page, click File Manager:
     
3. Locate the document root directory (public_html) of the domain where you created the custom error page.
4. Delete the related file for the error number. For example, if you created a custom error page for the 404 Not Found error, delete the 404.shtml file.

More Information

For more information about HTTP return codes, please visit https://documentation.cpanel.net/display/CKB/HTTP+Error+Codes+and+Quick+Fixes.