How to Manage Error Pages (404, 500)

An error page is what visitors see when something goes wrong: a missing page (404), a blocked folder (403) or a server fault (500). The server's plain default page tells visitors nothing and sends them away. A custom page in your site's style, with a link home or a search box, keeps them on your site. This guide shows how to set custom error pages on Domain India hosting with cPanel's Error Pages tool, with .htaccess, and in WordPress.

1. The error codes worth customising

Start with 404: real visitors see it most often. For finding the cause of the errors themselves, see understanding HTTP status codes in cPanel and DirectAdmin.

2. Custom error pages with cPanel's Error Pages tool

cPanel saves the page as a file named after the code, such as 404.shtml, in the domain's document root (public_html for your main domain). The server is set to use /404.shtml, /403.shtml and the other code files automatically, so no further change is needed. You can also create or edit those files directly in the File Manager.

The inserted tags are server-side includes, which work because the file ends in .shtml. For example, this line shows the address the visitor asked for:

<p>We couldn't find <!--#echo var="REQUEST_URI" --> on this site.</p>

3. Custom error pages with .htaccess

.htaccess works on our cPanel, DirectAdmin and Webuzo hosting, because the web server is Apache on all three. It is the way to use your own file names or a single folder of error pages.

Create the pages first, for example in a folder called errors inside public_html, then add these lines to the .htaccess file in public_html:

ErrorDocument 403 /errors/403.html
ErrorDocument 404 /errors/404.html
ErrorDocument 500 /errors/500.html
ErrorDocument 503 /errors/503.html

A self-contained 404 page you can start from:

<!doctype html>
<html lang="en">
<head>
  <meta charset="utf-8">
  <meta name="viewport" content="width=device-width, initial-scale=1">
  <title>Page not found | Your Business</title>
  <style>
    body { font-family: system-ui, sans-serif; max-width: 36rem; margin: 15vh auto; padding: 0 1rem; color: #222; }
    a { color: #0a58ca; }
  </style>
</head>
<body>
  <h1>Sorry, we can't find that page</h1>
  <p>It may have moved, or the link may be mistyped.</p>
  <p><a href="/">Go to the home page</a>.</p>
</body>
</html>

An ErrorDocument line in .htaccess takes priority over the server default, so it wins over a 404.shtml made with the cPanel tool. Keep styles inside the page and use links that start with /, because the error page can be shown at any address on your site and relative links break.

4. DirectAdmin and Webuzo

• DirectAdmin: the current DirectAdmin on our servers has no Custom Error Pages tool. Create 404.shtml in domains/yourdomain.com/public_html, which the server already uses for "not found", and use .htaccess for other codes. The full guide is managing custom error pages in DirectAdmin.
• Webuzo: use the .htaccess method in section 3. If a page doesn't appear, ask support.

5. When your custom page doesn't appear

On cPanel, a proxy cache sits in front of Apache and can keep an earlier copy of a page. When you test, add something like ?t=1 to the address to be sure you see the current response.

Check that a missing page really returns 404, not just the right look:

curl -sI "https://yourdomain.com/test-missing-page?t=1" | head -1

The first line should say 404. If it says 200, search engines treat every missing address as a real page (a "soft 404"). If you use a .php file as an error page, set the code at the top with http_response_code(404);.

6. WordPress 404 pages

In WordPress, the 404 page belongs to your theme:

• Block themes: open Appearance › Editor › Templates and edit the Page: 404 template.
• Classic themes: edit or add 404.php in a child theme, so a theme update doesn't overwrite it.

Add a search box and links to your main pages. For removed pages that have a new home, a 301 redirect is better than any 404 page; see links and redirects: 301, 302, 404 and 410.

7. What makes a good error page

• Say what happened in plain words. "We can't find that page" beats "Error 404".
• Offer a way forward: a link home, your main sections, a search box or a contact link.
• Keep it light: no large images or external scripts.
• Show no technical details such as file paths, server names or database messages.

8. Error pages on Domain India hosting

Every Domain India Linux hosting plan runs Apache with .htaccess support, and cPanel plans add the Error Pages editor. On cPanel and DirectAdmin, weekly JetBackup backups let you restore a file if an edit goes wrong. cPanel plans start at ₹125 a month and DirectAdmin at ₹100 a month (Domain India list prices on 24 September 2026, excluding 18% GST).

Ready to set up your error pages? Open cPanel from your hosting list, or read troubleshooting 500 Internal Server Error if a page is failing. Looking for hosting? Compare cPanel hosting plans.