PanelDOCSv1.0.0

Error pages

Show your own page when something goes wrong on a website — for a missing page (404), a server error (500) and other error codes.

Error pages lets you show your own page when something goes wrong on a website, such as a missing page (404). Each website and each error code can have its own page. Without one, visitors see the standard page.

Where: Control Panel › Websites › Error pages

Error pages screen

Error codes

Code Tab label When visitors see it
400 Bad request the browser sent a request the server can't read
401 Login required the page needs a login, for example a folder protected with Directory privacy
403 Forbidden the visitor may not open the page, for example a blocked IP
404 Not found the page does not exist
429 Too many requests the visitor sent too many requests in a short time, for example to a login page the site firewall limits
500 Server error the website's code failed
502 Bad gateway the website's software (PHP or the web server behind it) is not answering
503 Unavailable the website is temporarily unavailable
504 Gateway timeout the website's software took too long to answer

Both web servers

Your pages work whichever web server the website uses (Control Panel › Software › PHP settings, Nginx only or Nginx with Apache). They are also shown when the front web server answers by itself — a visitor blocked by an IP rule or the site firewall (403), too many requests (429), or the website's software down or too slow (502, 504) — and for missing pages on websites that run on Nginx only (404).

Note: while Maintenance mode is on, visitors see its "back soon" page, not your 503 page. Websites that run a Node.js app or a built single-page app answer their own errors.

Create a custom error page

  1. Choose the website in the picker at the top.
  2. Click the tab of the error code, for example 404.
  3. Edit the page in the editor. When there is no custom page yet, it is filled with a simple template to start from.
  4. Click Save (or press Ctrl+S / Cmd+S in the editor).

The pill above the editor changes from Standard page — edit below to customise to Custom page in use.

The page is saved as <code>.html in the website's folder, for example web/yourdomain.com/public_html/404.html. It can be up to 200,000 bytes.

Tip: use full links, such as /images/logo.png, for images and stylesheets. The page shows at any address, so relative links can break.

Go back to the standard page

  1. Choose the website and the error code.
  2. Click Use standard page.
  3. Confirm Remove the custom page?

The custom page file is deleted, and visitors see the standard page again.