Configure Custom Error Pages for an eCDN Zone
Set custom HTML error pages for 500-class and 1000-class errors generated by the embedded CDN for a zone.
Required Editions
| Available in: B2C Commerce |
When the embedded CDN generates a 500-class or 1000-class error, it can display a custom HTML page instead of a generic error. The custom page must be hosted at a publicly accessible URL on your B2C Commerce instance and must embed a specific error token so the CDN can render error details. 1000-class errors include Cloudflare 100x conditions such as DNS resolution failures and security challenge failures.
Use Custom Pages for these scenarios:
- 500 Class Errors - shown when a web server is unable to process a request (HTTP 5xx).
- 1000 Class Errors - shown when domain configuration, security settings, or origin setup prevents eCDN from completing the request.
- I am under attack Page - interstitial challenge shown to every visitor when Under Attack Mode is on.
- In Business Manager, click the App Launcher, and then select Administration | Sites | Embedded CDN Settings.
- Locate the zone you want to configure and select Configure Zone from the dropdown menu.
-
Select the Customization tab.
Customization tab — Custom Pages
-
In each custom page section, confirm your HTML page contains the required tokens listed
at the top of the form.
Without required tokens embedded in the HTML, the page can't be published.
-
In the Custom Pages: 500 Class Errors section, enter the URL of
the HTML page you want displayed when the embedded CDN generates a 500-class error.
The HTML page must embed the 500 error class token. For example:
<p>::CLOUDFLARE_ERROR_500S_BOX::</p>
Note The token is case-sensitive and must match exactly. -
In the Custom Pages: 1000 Class Errors section, enter the URL of
the HTML page you want displayed when the embedded CDN generates a 1000-class error.
The HTML page must embed the 1000 error class token. For example:
<p>::CLOUDFLARE_ERROR_1000S_BOX::</p>Note The token is case-sensitive and must match exactly. - In the I am under attack Page section, enter the URL for the challenge page shown while Under Attack Mode is enabled.
-
Click Publish.
The eCDN downloads the error page template from the URL you provided and stores it in the CDN infrastructure, making it available for all subdomains in the zone.
Note Repeat the Publish step whenever the error page template changes. Publishing is required each time to push the updated template to the CDN. -
(Optional) Use additional page actions as needed.
- Preview Default shows what eCDN serves when no custom URL is configured.
- Set to Default reverts to the eCDN default page and appears only when a custom URL is currently published.
Custom Pages actions for publish, preview, and defaults
