> For the complete documentation index, see [llms.txt](https://docs.authgear.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.authgear.com/authentication-and-access/authentication/passwords/forgot-reset-password-settings.md).

# Change Forgot/Reset Password settings

Configure password reset/account recovery processes.

The Forgot/Reset Password settings tab allows you to configure the behaviour of the account recovery process for your Authgear project.

## Enable Reset Password

Select a login method and navigate to the password settings tab. The login method chosen controls how the user can reset their password:

* Phone (OTP only)
* Email (link or OTP)
* Both

If both options are available, the user will be able to choose between using phone or email for account recovery.

### Recovery via phone

You can choose how you want the OTP to be delivered. In the following example, the user will receive an OTP via "WhatsApp or SMS". This means the user can select their preferred method during reset.

<figure><img src="https://2638622528-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MAjXpMovvVxeIY33s_K%2Fuploads%2Fgit-blob-84a881ed74d5326933bc83dd2a1f162debb3daab%2FScreenshot%202025-08-15%20at%2000.12.50.png?alt=media" alt=""><figcaption></figcaption></figure>

The valid duration (in seconds) for the OTP or reset link can also be customized. This duration does **not** determine the minimum delay before resending OTPs or links.

As an example, if OTP is enabled as the recovery method, users will see the following screen to verify their identity during password reset:

<figure><img src="https://2638622528-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MAjXpMovvVxeIY33s_K%2Fuploads%2Fgit-blob-d669ef36ba9e88559e8f038882e581d067e1e357%2FScreenshot%202025-08-15%20at%2020.53.16.png?alt=media" alt=""><figcaption></figcaption></figure>

Once you're done, save your changes to enable the new configuration.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.authgear.com/authentication-and-access/authentication/passwords/forgot-reset-password-settings.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
