Customizing the Expired Password Reset Link Message
This article provides steps to customize the page displayed for Auth0's Universal Login (UL) when a password reset link expires. When a user follows an expired link, an error page appears with the title Link Expired.
- Auth0 Universal Login
- Classic Universal Login
- New Universal Login
The method for customizing this page differs depending on the Universal Login version in use.
For New Universal Login
There are two methods to customize the error text for the New UL experience: using the Auth0 Dashboard or the Management API.
Dashboard Method
- Navigate to Branding > Universal Login.
- Select the Edit text and translations option.
- Set the Prompt to reset-password.
- Set the Screen to reset-password-error.
- Modify the text in the
eventTitleExpiredanddescriptionfields to the desired message.
Management API Method
Use the Set custom text for a specific prompt endpoint to programmatically update the text.
curl --request PUT \
--url 'https://{yourDomain}/api/v2/prompts/reset-password/custom-text/en' \
--header 'authorization: Bearer {yourMgmtApiAccessToken}' \
--header 'content-type: application/json' \
--data '{"reset-password-error": {"description": "The password reset link has expired. Please request a new one."}}'
For Classic Universal Login
The text on the expired link page cannot be edited directly for Classic UL. Instead, a custom error page must be configured.
- Navigate to Tenant Settings > Advanced.
- In the Error Page URL field, enter the URL for a custom error page that is hosted.
- Auth0 redirects to this URL on an error and includes query parameters, such as
erroranderror_description, that the custom page can use to display a context-specific message.