tencent cloud


Custom Error Page

Last updated: 2024-01-02 10:29:50


    EdgeOne provides support to redirect to a specified custom page and return a 302 status code when the origin server responds with specific error statuses. This helps your site inform users of the current website status by the customized error page, avoiding uncertainty regarding the specific cause and resolution when a request error occurs.
    This feature is the redirection of origin-pull error status. It does not support redirection of status codes generated by access control policies such as token authentication or web protection rules.


    For instance, your self-built e-commerce service website provides online payment capability through shop.example.com. During peak user traffic, the original server could potentially become overloaded, responding with a 503 status code. In order to avoid losing users, I hope to customize an error page https://www.example.com/error.html to guide users to other e-commerce platforms. You can follow the steps:
    1. Log in to the TencentCloud EdgeOne console, click Site List in the left sidebar and click the Site to be configured in the site list.
    2. On the site detail page, click on Rule Engine.
    3. On the rule engine management page, click on Create rule to enter the new rule's editing page. In this scenario, you can operate as follows:
    3.1 On the rule editing page, select the matching type as HOST equal to shop.example.com.
    3.2 Click Action, and select Custom Error Page in the pop-up action list.
    3.3 To configure the custom error page, select the Status code as 503 and enter https://www.example.com/error.html for the Page URL. The relevant configuration items are described as follows:
    Configuration Item
    Status code
    Specifies the error status code returned by the origin:
    4XX:400, 403, 404, 405, 414, 416, 451
    5XX:500, 501, 502, 503, 504
    Page URL
    Designate the error page address, for instance:https://www.example.com/custom-page.html
    4. The complete rule configuration is as shown below. Click Save and publish, the rule configuration will be completed.
    Contact Us

    Contact our sales team or business advisors to help your business.

    Technical Support

    Open a ticket if you're looking for further assistance. Our Ticket is 7x24 avaliable.

    7x24 Phone Support