Skip to main content
To customize multi-factor authentication SMS and voice messages sent by Auth0:
  1. Go to Dashboard > Security > Multi-factor Auth, and click Phone Message.
  2. In the Enrollment Template or Verification Template section, customize your message.
  3. Click Save.
The Enrollment Template defines the message sent when a user enrolls a new device for the first time using MFA. The Verificiation Template defines the message sent when a user logs in after enrollment.

​
Syntax

Liquid syntax is the supported templating engine you use when accessing user attributes in SMS templates. The following attributes are available:
AttributeDescription
message_typeIndicates which kind of message is sent: sms or voice.
codeEnrollment/verification code. When sending voice messages, variable values are separated by dots between the digits (1.2.3.4.5) for accurate pronunciation by voice messaging providers.
localeFor Universal Login or MFA API. Designates the language.
requestInfo.langFor Classic Login localization. Browser accept-language header. For example: es-AR,es;q=8.0, en-US,en.
tenant.friendlyNameThe Friendly Name set in Dashboard > Tenant Settings.
custom_domain.domainThe tenant’s domain name.
custom_domain.domain_metadataThe custom domain’s metadata fields (as key-value pairs).
An example of using Liquid syntax to send different messages for voice and SMS by language: 
{% if message_type == "voice" %}
    {% if locale contains "fr" %}
        Bonjour, vous avez demandé à recevoir un code de vérification pour vous enregister avec {{tenant.friendly_name}}. Votre code est: {{pause}} {{code}}. Je répète, votre code est: {{pause}}{{code}}.
    {% elsif locale contains "es" %}
        Usted ha requerido un código de verificación para inscribirse con {{tenant.friendly_name}}. Su código es: {{pause}}{{code}}. Repito, su código es: {{pause}}{{code}}.
    {% else %}
        Hello, you requested a verification code to enroll with {{tenant.friendly_name}}. Your code is: {{pause}}{{code}}. I repeat, your code is: {{pause}}{{code}}.
    {% endif %}
{% else %}
    {% if locale contains "fr" %}
        {{code}} est votre code de vérification pour vous enregistrer avec {{tenant.friendly_name}}.
    {% elsif locale contains "es" %}
        {{code}} es su código para inscribirse con {{tenant.friendly_name}}.
    {% else %}
        {{code}} is your verification code to enroll with {{tenant.friendly_name}}.
    {% endif %}
{% endif %}

​
Localization

In the Auth0 Authentication API, the Get Code or Link endpoint, MFA Challenge request endpoint, and MFA Add an authenticator endpoint support the x-request-language header. To use it, set your supported languages in Tenant > Settings (under Supported Languages). When the x-request-lanuage header is sent, that locale is available in the locale variable in the MFA phone message templates. See Passwordless Multi-Language Support for details.

​
Learn more