Vue Storefront is now Alokai! Learn More
Customize Response Pages

Customize Response Pages

The documentation only applies to instances deployed on Alokai@Edge.

Response pages let you serve custom HTML templates instead of the default error pages. You can define separate templates for specific HTTP status codes and enable them when needed.

General behaviorri:link

Available templates

You can upload and enable up to 4 custom response pages:

  • 401 Unauthorized
  • 403 Forbidden
  • 404 Not Found
  • 5xx Server errors (applies to all 500–599 responses)

Notes

  • Only one template per status group can be active (e.g., one file for 5xx).
  • If no custom template is enabled, the default Alokai@Edge error page is shown.
  • Keep files lightweight – large or complex HTML can slow down error handling.
  • Changes may take a few minutes to propagate.

Maintenance Moderi:link

In addition to error pages, you can configure a Maintenance Page that redirects all traffic to a custom HTML file during planned downtime. This feature includes an Maintenance allow IP list for selected users (e.g., your team) to bypass the maintenance screen.

For details, see Maintenance Mode documentation.