---
title: "corestack_error_pages_validate"
url: https://docs.corefinity.com/mcp/tools/corestack_error_pages_validate
type: tool
last_updated: 2026-11-13
feature: error-pages
related:
  - https://docs.corefinity.com/api/reference/site-settings/check-site-error-page.md
  - https://docs.corefinity.com/guides/sites/site-settings/error-and-maintenance-pages.md
---
# corestack_error_pages_validate

**Check an error page.** Checks one error or maintenance page without saving: what a save removes and what blocks it. Scope: read.

- Scope: `read`
- Runs as a task: no

## When to use it

Check one error or maintenance page without saving it, before `corestack_error_pages_update`. The answer is `{diagnostics, bytes}`: the same checks as `corestack_error_pages_preview` without the HTML.

Each diagnostic has `severity`, `code`, `message`, `line` and `column`. A `warning` whose `code` starts with `removed_` is something the save removes (for example `Removed <script>: scripts are not allowed`); the saved page is the page without it. An `error` blocks the save until you fix it: an unknown tag, a tag inside a link or CSS, `<!--#`, or a page over 64 KiB. Other warnings (no `<!DOCTYPE html>`, no viewport, an empty tag, a resource on another host) do not block anything.

Leave `source` out to check the saved page, or send `null` for the platform's page; `message` likewise.

## Inputs

- `site_id` (integer, ≥ 1, required): the environment row.
- `page` (string, required): `maintenance`, `404`, `500`, `502`, `503` or `504`.
- `source` (string or null, at most 64 KiB): the HTML to check. Left out: the saved page. Null: the platform's page.
- `message` (string or null, at most 300 characters): the `{{message}}` text. Left out: the saved one. Null: the default.

### Input schema

```json
{
  "additionalProperties": false,
  "properties": {
    "message": {
      "description": "The {{message}} text; null: the default; left out: the saved one.",
      "maxLength": 300,
      "type": [
        "string",
        "null"
      ]
    },
    "page": {
      "description": "The page: maintenance, 404, 500, 502, 503 or 504.",
      "enum": [
        "maintenance",
        "404",
        "500",
        "502",
        "503",
        "504"
      ],
      "type": "string"
    },
    "site_id": {
      "minimum": 1,
      "type": "integer"
    },
    "source": {
      "description": "HTML and CSS; null: the platform page; left out: the saved page.",
      "maxLength": 65536,
      "type": [
        "string",
        "null"
      ]
    }
  },
  "required": [
    "site_id",
    "page"
  ],
  "type": "object"
}
```

## Refusals

- `feature_off`: error pages are not available to you yet.
- `managed_elsewhere` (message: "This site is managed by another control panel"): another control panel manages this site, so use that control panel for it. This is refused before anything else about the site, as in the Control Panel and the API. Nothing was done.
- The refusals every tool can answer: `invalid_arguments`, `tenant_mismatch`, `scope_required`, `pin_refused`, `rate_limited`, `temporarily_unavailable`, `internal_error` (corestack://guides/how-this-server-works).

## Example

```json
{
  "name": "corestack_error_pages_validate",
  "arguments": {
    "site_id": 4211,
    "page": "503",
    "source": "<!DOCTYPE html>\n<html lang=\"en\"><head><meta charset=\"utf-8\"><title>{{status_text}}</title></head><body><h1>{{status_text}}</h1><p>{{message}}</p></body></html>\n"
  }
}
```

## Prompt

```text
Using the Corefinity MCP server, call corestack_error_pages_validate with site_id 4211, page 503, source <!DOCTYPE html>
<html lang="en"><head><meta charset="utf-8"><title>{{status_text}}</title></head><body><h1>{{status_text}}</h1><p>{{message}}</p></body></html>
. (Check an error page.) Tell me what it returned.
```

## The same task elsewhere

- Endpoint: [POST /api/corestack/sites/{site}/error-pages/validate](https://docs.corefinity.com/api/reference/site-settings/check-site-error-page.md)
- Guide: [Error pages](https://docs.corefinity.com/guides/sites/site-settings/error-and-maintenance-pages.md)
