Troubleshoot Error Pages issues

Cannot preview error page

If Cloudflare cannot load your site or you have blocked the United States (US) via IP Access rules or WAF custom rules, publishing and previewing a custom error page might not work.

A common error might look like the following: Error fetching page: Fetch failed, https://example.com/ipcountryblock.html returned 403 (Code: 1202).

Make sure that no WAF rule is blocking or challenging Custom Errors product when it is fetching the content of your custom error page.

Error pages for blocked requests

If you block countries or IP addresses with an IP Access rule, affected visitors will get a 1005 error and your IP/Country Block custom page.

If you block countries or IP addresses with a WAF custom rule and you do not configure a custom error rule or a WAF custom response for blocked requests, affected visitors will get your WAF Block page.

If you block requests due to a rate limiting rule and you do not configure a custom error rule or a WAF custom response for blocked requests, affected visitors will get your 429 Errors page displaying a Cloudflare 1015 error.

If you block countries or IP addresses with a firewall rule (now deprecated), affected visitors will get your 1000 Class Errors page.

1XXX errors

You cannot customize the following 1XXX errors via Error Pages:

• 1001 - Unable to resolve
• 1003 - Bad Host header
• 1018 - Unable to resolve because of ownership lookup failure
• 1023 - Unable to resolve because of feature lookup failure

Custom error page size

Your custom error page cannot be blank and the combined size of all page assets cannot exceed 1.5 MB (1,500,000 characters). To avoid exceeding the custom error page limit, preview your page to check its size before publishing.

General troubleshooting advice

If you encounter errors while attempting to preview or publish your custom error page, use an HTML validator ↗ to ensure that your code resolves properly.

More resources

• HTTP Status Codes
• Challenges