Email Verification Email Template

On this page

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 API, and for identity pre-verification. 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:

[#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
[#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.

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

[#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.

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.

verificationId
  • Type: String

The verification Id for the Verify Email API.

verificationOneTimeCode
  • Type: String

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