Skip to main content
Emails sent as part of Auth0 workflows each have a corresponding email template which determines the email’s from address, subject, message body, and more. After you configure an external SMTP email provider, you can modify email templates to customize your emails. Content fields in email templates support Liquid, an open-source templating language that extends the functionality of HTML. Liquid lets you:
  • Dynamically populate variables with data, like replacing {{ user.name }} with the user’s name
  • Implement logic, like if/else statements
  • Modify data with filters for string and array manipulation, math operators, and more
You can enable, disable, and customize email templates on the email templates page of the dashboard.

Overview

Read…To learn…
Customize email templatesHow to customize email templates
Supported Liquid syntaxAbout Liquid syntax (tags, filters, and variables) supported in email templates

Available email templates

The following is a summary of available email templates:
Email template nameSent when…Contains…
Blocked account emailAccess to an account from a specific IP address is blocked by brute-force protection.A link to re-enable the origin of the request.
Change password code emailA user requests a password changeA link to the password reset page and a code to use on that page.
Change password link emailA user requests a password changeA link to the password reset page.
MFA enrollment emailAn admin sends an Auth0 Guardian MFA enrollment invitation.A link that shows the MFA enrollment experience.
MFA verification code emailA user using a MFA email verifier needs a MFA verification codeAn MFA verification code
Password breach alert emailAuth0 detects that the user is trying to access the application with a password that has been leaked by a third partyInformational content
Passwordless OTP emailA user logs in with email authentication
User invitation emailA user is invited to an organization or applicationA link to join the organization
Verification code emailYou have enabled code-based verification and a user signs up or logs in for the first time, or you have enabled the Adaptive MFA policy and there is a low-confidence transaction for which account ownership must be verifiedA code that the user needs to enter during authentication
Verification link emailA user signs up or logs in for the first timeA link to verify the user’s email
Welcome emailThe user verifies their email address (if this template is enabled), or when the user signs up or logs in for the first time (if disabled)Informational content

Email template limits

  • Email template customization is not available when using the built-in email provider. To use email templates, configure an external SMTP email provider.
  • Each type of email has exactly one template. You can use Liquid to implement conditionals and other logic for use cases like multilingual emails.
  • Email templates do not support plain text emails. All emails must be HTML.
  • In the MFA enrollment email template, the connection.name variable is not available.
  • In the Passwordless OTP email template, only the email property of the user object is available.
  • Unlike other email templates, the Passwordless OTP email template is configured on the Passwordless Connections email settings page rather than the Email Templates page.
  • For security purposes, the From Address in email templates may not contain @auth0.com. If you enter an @auth0.com email address in From Addresses, your tenant sends only default emails, ignoring any customization. Private Cloud users may configure a similar domain DenyList.