In the event of an authorization error, you may choose to display to your users either the default Auth0 error page or a customized error page.

This article will show you how to use a customized error page. For details on the default Auth0 error page see Error Pages.

If you choose to display a custom error page, you have two options:

• Redirect the user to a custom error page
• Configure Auth0 to render a custom error page on your behalf. This feature is only available via the Management API.

You can configure Auth0 to redirect users to a custom error page, using the Dashboard or the Management API.

If you use the Dashboard, follow these steps:

1. Log in to the Dashboard.
2. Click on your tenant name in the top right corner to bring up the associated dropdown box.
3. Select Settings to open the Tenant Settings page.
4. Scroll down to the Error Pages section.
5. Select the option Redirect users to your own error page.
6. Provide the URL of the error page you would like your users to see.

Instead of using the Management Portal, you may configure your error pages by making the appropriate PATCH /api/v2/tenants/settings call to the Management API.

To redirect users to a custom error page, update the url field of your JSON body to point to the location of the error page.

If you use the API instead, use the PATCH /api/v2/tenants/settings endpoint. Update the url field of your JSON body to point to the location of the error page.

You can render your custom error page with Liquid syntax using the following variables:

• {client_id}
• {connection}
• {lang}
• {error}
• {error_description}
• {tracking}
• {logo_url}

To provide the appropriate HTML, pass in a string containing the appropriate Liquid syntax to the html element: