Email Update Email Template

On this page

FusionAuth sends this email when a user's email address changes. FusionAuth sends the email twice: once to the previous address and once to the new address. Assign the template in Identity update on the Tenants -> Your Tenant -> Identities tab. To override the template for one Application, set the template on the Applications -> Your Application -> Identities tab.

Example Template#

FusionAuth ships no default for this template. Start from the following example:

<p>
[#if previousEmail??]
  The email address for your account changed from ${previousEmail} to ${user.email}.
[#else]
  The email address ${user.email} was added to your account.
[/#if]
</p>
<p>
  If you didn't make this change, contact support right away.
</p>
- FusionAuth Admin
[#if previousEmail??]
The email address for your account changed from ${previousEmail} to ${user.email}.
[#else]
The email address ${user.email} was added to your account.
[/#if]

If you didn't make this change, contact support right away.

- FusionAuth Admin

Replacement Variables#

application
  • Type: Application

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.

event
  • Type: Object

The User Email Update event. For field definitions, see the User Email Update event reference.

previousEmail
  • Type: String

The email address before the change. The value is null when the user had no email address.

tenant
  • Type: Tenant

The Tenant object. For field definitions, see the Tenant API.

user
  • Type: User

The User object, with the new email address. For field definitions, see the User API.