# Email Verification Email Template

Learn when FusionAuth sends the email that asks a user to verify an email address, 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 to verify a user's email address: after a user registers or changes an email address, when you call the [Verify Email](https://fusionauth.io/docs/apis/users/verify-email.md) API, and for [identity pre-verification](https://fusionauth.io/docs/users/verify/identity-pre-verification-using-email.md). Assign the template in **Verification template** on the Tenants -> Your Tenant -> Identities tab. To override the template for one Application, set **Verification template** on the Applications -> Your Application -> Identities tab.

## Default Template

FusionAuth ships the following default template:

```ftl
[#if user.verified]
Pro tip, your email has already been verified, but feel free to complete the verification process to verify your verification of your email address.
[/#if]

[#-- When a one-time code is provided, you will want the user to enter this value interactively using a form. In this workflow the verificationId
     is not shown to the user and instead the one-time code must be paired with the verificationId which is usually in a hidden form field. When the two
     values are presented together, the email address can be verified --]
[#if verificationOneTimeCode??]
<p>To complete your email verification enter this code into the email verification form.</p>
<p> ${verificationOneTimeCode} </p>
[#else]
To complete your email verification click on the following link.
<p>
  [#assign url = "${baseUrl}/email/verify/${verificationId}?client_id=${(application.oauthConfiguration.clientId)!''}&tenantId=${tenant.id}" /]
  <a href="${url?html}">
    ${url?html}
  </a>
</p>
[/#if]

- FusionAuth Admin
```

```ftl
[#if user.verified]
Pro tip, your email has already been verified, but feel free to complete the verification process to verify your verification of your email address.
[/#if]

[#-- When a one-time code is provided, you will want the user to enter this value interactively using a form. In this workflow the verificationId
     is not shown to the user and instead the one-time code must be paired with the verificationId which is usually in a hidden form field. When the two
     values are presented together, the email address can be verified --]
[#if verificationOneTimeCode??]
To complete your email verification enter this code into the email verification form.

${verificationOneTimeCode}
[#else]
To complete your email verification click on the following link.

${baseUrl}/email/verify/${verificationId}?client_id=${(application.oauthConfiguration.clientId)!''}&tenantId=${tenant.id}
[/#if]

- 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`.

`state`

*   Type: `Object`

The **`state`** from the verification 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. During identity pre-verification, no user exists yet, so the object has only \*\*\`tenantId\`\*\*. For field definitions, see the [User API](https://fusionauth.io/docs/apis/users.md).

`verificationId`

*   Type: `String`

The verification Id for the [Verify Email](https://fusionauth.io/docs/apis/users/verify-email.md) API.

`verificationOneTimeCode`

*   Type: `String`

The one-time code for the gated email verification workflow. The user enters the code to verify the email address.

Related

[Email Email Template Reference Learn about the email templates FusionAuth sends and the replacement variables each template receives. freemarkeremail verification 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 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.
- [Forgot Password Email Template](https://fusionauth.io/docs/email/template-reference/account/forgot-password.md): Learn when FusionAuth sends the forgot password email, 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.
