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 AdminReplacement Variables#
applicationThe 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]
baseUrlThe base URL for links in the email. FusionAuth uses the Application baseURL, then the Tenant baseURL, then http://localhost:9011.
stateThe state from the verification request. The variable is present only when the request includes state.
tenantThe Tenant object. For field definitions, see the Tenant API.
userThe 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.
verificationIdThe verification Id for the Verify Email API.
verificationOneTimeCodeThe one-time code for the gated email verification workflow. The user enters the code to verify the email address.
Related
Learn about the email templates FusionAuth sends and the replacement variables each template receives.
API documentation for the FusionAuth Create an Email Template API.
Learn about the APIs for creating, retrieving, updating and deleting email templates as well as sending emails to users.
API documentation for the FusionAuth Preview an Email Template API.