Error Pages
Custom Error Pages
Replace the built-in error responses with your own branded HTML. Manage them in the dashboard under Error Pages (/account/error-pages). One active template per error type takes over the response Ngris serves at the edge for that condition; with no active template the built-in default is used.
custom_error_pages entitlement (EntitlementCustomErrorPages). Without it, upload and activate are rejected; deleting or deactivating an existing template still works so a downgraded account can clean up.Template types
Each template targets one error scenario. You activate at most one template per type:
| Type | Shown when |
|---|---|
| firewall | A firewall rule blocks the request. |
| rate_limit | A rate-limit rule throttles the request. |
| bad_gateway | 502 — bad gateway. |
| service_unavailable | 503 — service unavailable / origin offline. |
| not_found | 404 — not found. |
| request_timeout | 408 — request timeout. |
| internal_error | 500 — internal error. |
| gateway_timeout | 504 — gateway timeout. |
Uploading a template
Pick a template type and upload an HTML file. Constraints:
- Size — the uploaded file is capped (roughly 100 KB); larger files are rejected.
- Valid type — the type must be one of the values above.
AI content-safety check
Before storing, the HTML is screened by an AI content-safety validator (checking for XSS, crypto-miners, trackers, phishing). If the check flags the content, the upload is rejected with the reason. If the validation service is unavailable the upload is held rather than stored unchecked.
A freshly uploaded template is stored inactive by default; activate it as a separate step.
Activate, deactivate & delete
- Activate — make a template the live error page for its type. Activating one template deactivates any other active template of the same type, so there's always at most one active per type. (Requires the custom-error-pages entitlement.)
- Deactivate — clear the active flag; traffic falls back to the built-in default page for that type.
- Delete — remove a template you no longer need.
All templates and these actions are scoped to your account, so co-members see and manage the same set.