# Forgot Password Email Template

Learn when FusionAuth sends the forgot password email, and which variables the template receives.

> For the index of this section of the site, see [llms.txt](https://fusionauth.io/docs/llms.txt)

FusionAuth sends this email when a user starts the forgot password workflow, on the hosted login pages or through the [Forgot Password](https://fusionauth.io/docs/apis/users/forgot-password.md) API. The default template is also known as the Change Password template. Assign the template in **Forgot password** on the Tenants -> Your Tenant -> Identities tab. To override the template for one Application, set the template on the Applications -> Your Application -> Identities tab.

## Default Template

FusionAuth ships the following default template:

```ftl
[#setting url_escaping_charset="UTF-8"]
To change your password click on the following link.
<p>
  [#-- The optional 'state' map provided on the Forgot Password API call is exposed in the template as 'state'.
       If we have an application context, append the client_id to ensure the correct application theme when applicable.
  --]
  [#assign url = "${baseUrl}/password/change/${changePasswordId}?client_id=${(application.oauthConfiguration.clientId)!''}&tenantId=${user.tenantId}" /]
  [#list state!{} as key, value][#if key != "tenantId" && key != "client_id" && value??][#assign url = url + "&" + key?url + "=" + value?url/][/#if][/#list]
  <a href="${url?html}">${url?html}</a>
</p>
- FusionAuth Admin
```

```ftl
[#setting url_escaping_charset="UTF-8"]
To change your password click on the following link.

  [#-- The optional 'state' map provided on the Forgot Password API call is exposed in the template as 'state'.
       If we have an application context, append the client_id to ensure the correct application theme when applicable.
  --]
[#assign url = "${baseUrl}/password/change/${changePasswordId}?client_id=${(application.oauthConfiguration.clientId)!''}&tenantId=${user.tenantId}" /]
[#list state!{} as key, value][#if key != "tenantId" && key != "client_id" && value??][#assign url = url + "&" + key?url + "=" + value?url/][/#if][/#list]

${url}

- FusionAuth Admin
```

## Replacement Variables

`application`

*   Type: `Application`
*   Available since `1.21.0`

The Application object. For field definitions, see the [Application API](https://fusionauth.io/docs/apis/applications.md).

The variable is present only when the request that sends the email identifies an Application. Check for the variable before you use it:

```ftl
[#if application??]
  ${application.name}
[/#if]
```

`baseUrl`

*   Type: `String`
*   Available since `1.68.0`

The base URL for links in the email. FusionAuth uses the Application **baseURL**, then the Tenant **baseURL**, then `http://localhost:9011`.

`changePasswordId`

*   Type: `String`

The change password Id for the [Change a User's Password](https://fusionauth.io/docs/apis/users/change-password.md) API.

`state`

*   Type: `Object`

The **`state`** from the forgot password request. The variable is present only when the request includes **`state`**.

`tenant`

*   Type: `Tenant`
*   Available since `1.18.2`

The Tenant object. For field definitions, see the [Tenant API](https://fusionauth.io/docs/apis/tenants.md).

`user`

*   Type: `User`

The User object for the recipient. For field definitions, see the [User API](https://fusionauth.io/docs/apis/users.md).

Related

[Email Email Template Reference Learn about the email templates FusionAuth sends and the replacement variables each template receives. freemarkerforgot password template](https://fusionauth.io/docs/email/template-reference.md)

[APIs Create an Email Template API API documentation for the FusionAuth Create an Email Template API. freemarker](https://fusionauth.io/docs/apis/emails/create-an-email-template.md)

[APIs Email API Learn about the APIs for creating, retrieving, updating and deleting email templates as well as sending emails to users. freemarker](https://fusionauth.io/docs/apis/emails.md)

[APIs Preview an Email Template API API documentation for the FusionAuth Preview an Email Template API. freemarker](https://fusionauth.io/docs/apis/emails/preview-an-email-template.md)
---

## Other pages in Account

> For the full index of this section, see [Email](https://fusionauth.io/docs/llms-email.txt).

- [Email Verification Email Template](https://fusionauth.io/docs/email/template-reference/account/email-verification.md): Learn when FusionAuth sends the email that asks a user to verify an email address, and which variables the template receives.
- [Email Verified Email Template](https://fusionauth.io/docs/email/template-reference/account/email-verified.md): Learn when FusionAuth sends the email that confirms a verified email address, and which variables the template receives.
- [Passwordless Login Email Template](https://fusionauth.io/docs/email/template-reference/account/passwordless-login.md): Learn when FusionAuth sends the passwordless login email, and which variables the template receives.
- [Registration Verification Email Template](https://fusionauth.io/docs/email/template-reference/account/registration-verification.md): Learn when FusionAuth sends the email that asks a user to verify a registration, and which variables the template receives.
- [Set Up Password Email Template](https://fusionauth.io/docs/email/template-reference/account/set-up-password.md): Learn when FusionAuth sends the email that asks a new user to set up a password, and which variables the template receives.
