Custom Error Page
The CloudBase HTTP Gateway supports custom error pages: when a request returns a 4XX client error, the gateway returns your custom HTML error page to users instead of the default one, ensuring brand consistency and a better guidance experience in error scenarios.
Availability
Custom error pages are currently only available for platform users.
Entry
Go to CloudBase Console - Platform Settings - Custom Domain, and click "Configure Error Page" in the "Custom Error Page" area.
Configure an Error Page
- Click "Configure Error Page".
- Select the error status codes to customize (only 4XX client error status codes are supported, such as 401, 403, 404).
- Upload your custom error page file. Supported formats:
.html/.htm/.json/.xml, with a maximum size of 2 MB per file. - After saving, error requests with the selected status codes will return your uploaded error page.
Note
- Custom error pages are returned for the selected 4XX client errors.
- Only one error page can be configured per status code; if configured repeatedly, the most recently uploaded file takes effect.
Managing Error Pages
Once configured, the error page list shows the active configurations:
| Column/Action | Description |
|---|---|
| Status Codes | Status codes covered by this error page, such as 401, 403, 404, 405, 408, 414, 420, 431 |
| Error Page File | The uploaded custom error page file name, e.g., error-page-xxxx.html |
| Edit | Modify the status code range or replace the error page file |
| Preview | View the error page. The dialog provides two tabs: Preview shows the actual rendered effect of the error page, and Page Content displays the source code of the error page file |
| Delete | Delete the configuration; the corresponding status codes fall back to the default error page |
Tip
It is recommended to cover common status codes (e.g., 404, 403) and include guidance entries such as "Back to Home" or "Contact Support" on the error page to reduce user churn in error scenarios.