Email templates

Learn how email templates change after the upgrade.

Change summary Email templates may now contain application context, and email templates for sign-in flows also contain a magic link. The default expiration of email links has changed to five minutes, and you can customize that in five-minute increments up to 30 minutes.

You can now manage email templates through APIs.

Admin experience After the upgrade to Identity Engine, all of your customizations remain intact. Verify your templates to ensure they perform as expected.

  • Because both Classic Engine and Identity Engine use the Velocity Template Language, you no longer have to select different templates according to your configuration.

  • The enhanced functionality that currently allows for one-time password (OTP) code remains in some templates. If you remove the code for the default email magic links, the legacy six-number OTP is restored.

  • Classic Engine APIs don't work with Identity Engine features like OTP and email magic link.

  • You can now add application context attributes to email templates. New attributes include ${app.id}, ${app.name}, and ${app.label}.

  • The term multifactor authenticator doesn't automatically change to security method in the email body text. If you want to use the new wording, update the email templates manually or reset the email templates to their default state.

  • You can now configure the expiration of email links for self-service password reset, self-service account unlock, and multifactor authentication in the same place. In the Admin Console, go to SecurityAuthenticatorsAdd authenticator. Select Email.

User experience If you configure Email as an authenticator, users can sign in to the app using the magic link or OTP sent to their email address.

Users see the following minor text updates:

  • The message "Can't use the link? Enter a code instead" appears in the password reset and account unlock templates.
  • Title references to multifactor authentication changed to security method.
Related topics Customize an email template

Velocity Template Language

Configure the email authenticator