---
title: "Error pages"
url: https://docs.corefinity.com/guides/sites/site-settings/error-and-maintenance-pages
type: guide
last_updated: 2026-11-13
feature: error-pages
related:
  - https://docs.corefinity.com/api/reference/site-settings/get-site-error-pages.md
  - https://docs.corefinity.com/api/reference/site-settings/replace-site-error-pages.md
  - https://docs.corefinity.com/api/reference/site-settings/copy-site-error-pages.md
  - https://docs.corefinity.com/api/reference/site-settings/get-site-error-pages-operation.md
  - https://docs.corefinity.com/api/reference/site-settings/preview-site-error-page.md
  - https://docs.corefinity.com/api/reference/site-settings/reset-site-error-pages.md
  - https://docs.corefinity.com/mcp/tools/corestack_error_pages_get.md
  - https://docs.corefinity.com/mcp/tools/corestack_error_pages_preview.md
  - https://docs.corefinity.com/mcp/tools/corestack_error_pages_validate.md
  - https://docs.corefinity.com/mcp/tools/corestack_error_pages_update.md
  - https://docs.corefinity.com/mcp/tools/corestack_error_pages_test.md
  - https://docs.corefinity.com/mcp/tools/corestack_error_pages_history_list.md
---
# Error pages

Choose what visitors see when a site is in maintenance or answers with an error, and write your own pages.

## Before you start

- You can open the site in **Managed Websites**. Anyone who can open a site can change its error pages.
- Each environment has its own error pages: choose **Production** or **Staging** in the site header first.

## See what visitors see

1. **Open the site's error pages**

   Go to **Managed Websites**, choose the site, then **Error pages** under **Site settings**. The table lists the six pages and what each shows now.

   _Screenshot: A site page with Error pages ringed in the section menu. The table lists Maintenance, 503, 502, 504, 500 and 404, with When it is used, Visitors see and Last change, under the buttons Preview and Edit._

2. **Preview a page**

   Choose **Preview**, then a page along the top. Nothing on the site changes.

   _Screenshot: The Preview panel showing the maintenance page on a desktop and a phone, with the pages Maintenance, 503, 502, 504, 500 and 404 along the top and the sample values on the right._

| Visitors see        | Meaning                              |
| ------------------- | ------------------------------------ |
| **Platform page**   | Corefinity's page for that status.   |
| **Your page**       | The page you wrote.                  |
| **Your app's page** | Exactly what your application sends. |

## Write your own page

1. **Choose what each page shows**

   Choose **Edit**. For **Maintenance page** and for each status from **503** to **404**, choose **Platform page** or **Your page**; a status also offers **Show your app's page**.

   _Screenshot: The error page settings: the Maintenance page block with Platform page, Your page, Write your own and Preview, then Show the error page or Show your app's page for 503, 502, 504, 500 and 404, with 502 and 500 set to Your page beside Edit HTML, and Shared details with Support email._

2. **Write the page**

   Choose **Write your own**: the editor starts from the platform's page. Change the HTML, enter a **Message**, choose a tag such as `{{site_name}}` to insert it, then choose **Done**.

   _Screenshot: The page editor on maintenance.html: the list of pages and the Message box on the left, the HTML in the middle, and the tags to insert with Problems on the right._

3. **Review and save**

   Choose **Review changes**, check the list, then **Save and apply**.

   _Screenshot: The Review your changes dialog listing Your page instead of the platform page and Message changed, a Note for History box, and the buttons Back and Save and apply._

The change applies straight away and the card reads **Applied**. If it cannot be applied, the site keeps the pages it had and the card says why.

A page is plain HTML and CSS of up to 64 KB, and all pages together up to 256 KB. Scripts and forms are taken out when you save.

## When visitors see the maintenance page

The maintenance page always blocks visitors while [maintenance mode](/guides/sites/create-and-manage/maintenance-mode) is on. Deployments and platform maintenance show it only while **503** is set to **Show the error page**.

## Go back to earlier pages

Every save is a revision. Open the card's **…** menu for both ways back:

- **History**, then **Revert to this** on a revision, brings back that save.
- **Reset to platform defaults** puts every page back as on a new site.

## Automate this

**API:** [Replace a site's error pages](https://docs.corefinity.com/api/reference/site-settings/replace-site-error-pages.md), scope `write`

```bash
curl -X PUT https://manage.corefinity.com/api/corestack/sites/1042/error-pages \
  -H "Authorization: Bearer $COREFINITY_TOKEN" \
  -H "Accept: application/json" \
  -H "Content-Type: application/json" \
  -d '{
    "config": {
      "codes": {
        "404": "app",
        "500": "page",
        "502": "page",
        "503": "app",
        "504": "page"
      },
      "pages": {
        "404": {
          "message": null,
          "source": null
        },
        "500": {
          "message": null,
          "source": null
        },
        "502": {
          "message": null,
          "source": null
        },
        "503": {
          "message": null,
          "source": null
        },
        "504": {
          "message": null,
          "source": null
        },
        "maintenance": {
          "message": "Back at 10:00 UTC",
          "source": null
        }
      },
      "support_email": "help@harbourandfinch.example.com"
    },
    "note": "Our app shows its own holding page",
    "version": 2
  }'
```

**MCP:** [`corestack_error_pages_update`](https://docs.corefinity.com/mcp/tools/corestack_error_pages_update.md), scope `write`

```json
{
  "name": "corestack_error_pages_update",
  "arguments": {
    "site_id": 4211,
    "version": 3,
    "codes": {
      "503": "app"
    },
    "note": "Show the shop's own holding page"
  }
}
```

**Control Panel:** Managed Websites › your site › Site settings › Error pages ([https://manage.corefinity.com/go/error-pages](https://manage.corefinity.com/go/error-pages))

## Related

- [Maintenance mode](/guides/sites/create-and-manage/maintenance-mode): Show visitors a maintenance page.
- [Logs](/guides/sites/logs-and-monitoring/logs): Read and narrow a site's logs.
- [Redirects](/guides/sites/site-settings/redirects): Send visitors from one path to another.
