How to add custom error pages

Error pages are displayed when a user enters a wrong/outdated URL or when one is not authorized to access a specific directory of your web space. cPanel allows you to customize the default view and adjust the way the error is displayed:

for cPanel paper_lantern theme
for cPanel x3 theme


for cPanel paper_lantern theme:

1. Log into your cPanel.
2. Navigate to Advanced section > Error Pages menu:



3. Select the domain name in from Managing drop-down menu and click on the error you wish to change:



If you cannot find the needed error code in Edit Common Error Codes tab, switch to Show All HTTP Error Status Codes:



4. Once the error code is selected, you will be taken to HTML editor that provides the following tags:

  • Requested URL: displays the intended URL the visitor is trying to view.
  • Server name: displays the web site's server name.
  • Visitor's browser: displays the visitor's browser type such as Internet Explorer, FireFox, Netscape, etc.
  • Redirect Status Code: displays the type of code in the 300-307 range, to learn more follow this link.




  • Make sure that you Save the changes.

    5. After that the .shtml file will be placed to the root directory of your website:



    6. In order to connect .shtml to your website, you need to add the corresponding rule to .htaccess file.

    If you cannot locate .htaccess, enable Show Hidden files (dotfiles) option in Settings menu:



    If there is still no .htaccess file in your File manager, feel free to create a new one using File option:



    7. After that right-click on the file and use Edit option:



    Add the following rule:

    ErrorDocument 500 /500.shtml

    Note, that error code and file name should be adjusted accordingly. For example, if you wish to connect 404.shtml, the rule should look like:

    ErrorDocument 404 /404.shtml




    for cPanel x3 theme:

    1. Log into your cPanel.
    2. Navigate to Advanced section > Error Pages menu:



    3. Select the domain name in from Managing drop-down menu and click on the error you wish to change:



    If you cannot find the needed error code in Edit Common Error Codes tab, switch to Show All HTTP Error Status Codes:



    4. Once the error code is selected, you will be taken to HTML editor that provides the following tags:

  • Requested URL: displays the intended URL the visitor is trying to view.
  • Server name: displays the web site's server name.
  • Visitor's browser: displays the visitor's browser type such as Internet Explorer, FireFox, Netscape, etc.
  • Redirect Status Code: displays the type of code in the 300-307 range, to learn more follow this link.




  • Do not forget to Save the changes.

    5. After that the .shtml file will be placed to the root directory of your website.

    Move to File Manager menu in cPanel, select Document root for option and your domain from the drop-down menu. Make sure that Show Hidden Files (dotfiles) is enabled:





    6. In order to connect .shtml to your website, you need to add the corresponding rule to .htaccess file.

    If you cannot locate .htaccess file in your website root directory, feel free to create a new one using New File option:



    7. After that right-click on the file and use Edit option:



    Add the following rule:

    ErrorDocument 500 /500.shtml

    Note, that error code and file name should be adjusted accordingly. For example, if you wish to connect 404.shtml, the rule should look like:

    ErrorDocument 404 /404.shtml


    That's it!

                  
                          Need any help? Contact our HelpDesk

    Comments

    We welcome your comments, questions, corrections and additional information relating to this article. Your comments may take some time to appear. Please be aware that off-topic comments will be deleted.

    If you need specific help with your account, feel free to contact our Support Team. Thank you.

    Need help? We're always here for you.

    × Close