Customizing the Expired Password Reset Link Message

Overview

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.

Applies To
  • Auth0 Universal Login
  • Classic Universal Login
  • New Universal Login
Solution

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

  1. Navigate to Branding > Universal Login.
  2. Select the Edit text and translations option.
  3. Set the Prompt to reset-password.
  4. Set the Screen to reset-password-error.
  5. Modify the text in the eventTitleExpired and description fields 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.

  1. Navigate to Tenant Settings > Advanced.
  2. In the Error Page URL field, enter the URL for a custom error page that is hosted.
  3. Auth0 redirects to this URL on an error and includes query parameters, such as error and error_description, that the custom page can use to display a context-specific message.

Recommended content

No recommended content found...