Syntaxe Liquid prise en charge pour modèles de courriel

Une liste des balises Liquid, des filtres et des variables courantes prises en charge dans les modèles de courriel.

Pour un aperçu de la syntaxe Liquid, consultez l’introduction à LiquidJS. Vous y trouverez un bref résumé des deux types de balisage de Liquid :

• Sorties, qui affichent du HTML.

  La syntaxe des sorties consiste en une variable ou une valeur, ainsi qu’une liste facultative de filtres, entourées de {{ et }}. Par exemple, {{ user.name }}.

• Balises, qui contrôlent le rendu du modèle et implémentent la logique.

  La syntaxe des balises consiste en un nom de balise et des arguments facultatifs entourés de {% et %}. Par exemple, {% if user_metadata.lang == 'it' %} Ciao! {% endif %}.

Cette page répertorie les balises, les filtres et les variables pris en charge dans les modèles de courriel.

​

Balises

Tous les modèles de courriel prennent en charge les balises Liquid suivantes :

Catégorie	Balises
Itération	for, cycle, tablerow
Flux de contrôle	if, unless, elsif, else, case
Variable	assign, increment, decrement
Fichier	include, layout
Langage	raw, comment

Vous pouvez consulter des descriptions et des exemples de balises Liquid sur la page des balises de LiquidJS.

​

balise debug

Pour faciliter le débogage et le développement, notre balise personnalisée {% debug %} affiche un résumé des variables de modèle disponibles dans votre modèle au moment du rendu.

​

Filtres

Tous les modèles de courriels prennent en charge les filtres Liquid suivants :

Catégorie	Filtres
Math	plus, minus, modulo, times, floor, ceil, round, divided_by, abs, at_least, at_most
Chaîne	append, prepend, capitalize, upcase, downcase, strip, lstrip, rstrip, strip_newlines, split, replace, replace_first, remove, remove_first, truncate, truncatewords
HTML/URI	escape, escape_once, url_encode, url_decode, strip_html, newline_to_br
Tableau	slice, map, sort, sort_natural, first, last, join, reverse, size
Date	date
Divers	default

Vous trouverez la description et des exemples des filtres Liquid sur la page des filtres de LiquidJS.

​

Variables générales

Les variables suivantes sont disponibles pour les champs From Address, Subject et Message de chaque modèle (sauf indication contraire).

Pour utiliser des propriétés non fiables dans les modèles de courriel, échappez-les à l’aide du filtre escape (par exemple, {{ user.name | escape }}).

• L’objet application, qui donne accès aux propriétés client standard comme application.name et application.client_metadata

• request_language, pour la sélection de la langue des utilisateurs

• connection.name

• Dans le modèle de courriel d’inscription à l’AMF, la variable connection.name n’est pas disponible.

• Renseignements liés au tenant définis dans Tenant Settings :

  • tenant, qui correspond au nom brut du tenant
  • friendly_name
  • support_email
  • support_url

• Les variables user suivantes :

  • user.email
  • user.email_verified
  • user.picture (non fiable)
  • user.nickname (non fiable)
  • user.given_name (non fiable)
  • user.family_name (non fiable)
  • user.name (non fiable)
  • user.app_metadata, des attributs utilisateur qui peuvent avoir une incidence sur les fonctionnalités de base d’un utilisateur, par exemple sur le fonctionnement d’une application ou sur ce à quoi l’utilisateur peut accéder, y compris son plan de soutien, ses rôles de sécurité et ses groupes de contrôle d’accès
  • user.user_metadata (non fiable s’il contient des renseignements fournis par l’utilisateur), des attributs utilisateur qui n’ont pas d’incidence sur les fonctionnalités de base d’un utilisateur, y compris ses préférences

Dans le modèle de courriel Passwordless OTP, seule la propriété email de l’objet user est disponible.

• Lorsqu’un utilisateur ouvre une session par l’entremise d’une Organization, les variables supplémentaires suivantes sont disponibles :

  • organization.id
  • organization.display_name
  • organization.name
  • organization.metadata
  • organization.branding.logo_url
  • organization.branding.colors.primary
  • organization.branding.colors.page_background

• Variables pour les domaines personnalisés multiples :

  • custom_domain.domain, le nom de domaine personnalisé utilisé (p. ex., login.example.com)
  • custom_domain.domain_metadata, les champs de métadonnées du domaine personnalisé (paires clé-valeur) que vous pouvez utiliser pour personnaliser le contenu du courriel selon le domaine

Lorsque vous utilisez plusieurs domaines personnalisés, Auth0 utilise automatiquement le domaine personnalisé approprié pour les liens contenus dans les courriels. Vous pouvez utiliser ces variables pour personnaliser le contenu du courriel selon le domaine personnalisé qui a généré le courriel.

Exemple : personnaliser l’image de marque du courriel selon les métadonnées du domaine personnalisé :

{% if custom_domain.domain_metadata.brand == "BrandA" %}
  <h1 style="color: #0000FF;">Welcome to Brand A</h1>
{% elsif custom_domain.domain_metadata.brand == "BrandB" %}
  <h1 style="color: #FF0000;">Welcome to Brand B</h1>
{% else %}
  <h1>Welcome</h1>
{% endif %}

Exemple : Incluez des renseignements de soutien propres au domaine :

{% if custom_domain.domain_metadata.support_email %}
  <p>Need help? Contact us at {{ custom_domain.domain_metadata.support_email }}</p>
{% else %}
  <p>Need help? Contact us at {{ support_email }}</p>
{% endif %}

Pour utiliser des domaines personnalisés dans les courriels, assurez-vous d’avoir :

1. configuré et vérifié vos domaines personnalisés
2. activé Use Custom Domain in Emails dans Dashboard > Branding > Custom Domains
3. défini un domaine personnalisé par défaut si vous utilisez plusieurs domaines personnalisés

​

Variables de Redirect To

Dans les modèles de courriel comportant un champ d’URL Redirect To, seules les trois variables suivantes sont prises en charge :

Les valeurs Redirect To personnalisées ne sont pas offertes pour les tenants non Enterprise créés le 5 mai 2026 ou après cette date. Consultez URL Lifetime et Redirect to.

• application.name (ou son synonyme client.name)

• application.clientID

• application.callback_domain (ou son synonyme client.callback_domain), qui contient l’origine de la première URL figurant dans la liste Allowed Callback URL de l’application. Comme il s’agit d’une origine, elle comprend aussi le protocole (comme https://) en plus du domaine.

  Le domaine de rappel vous permet de rediriger les utilisateurs vers un chemin de l’application qui a déclenché l’action à l’aide d’une syntaxe comme {{ application.callback_domain }}/result_page.

​

Variables propres aux modèles

En plus des variables Liquid communes offertes à tous les modèles de courriel, les modèles de courriel suivants comportent des variables supplémentaires.

​

Variables du modèle de courriel pour un compte bloqué

• user.source_ip
• user.city
• user.country
• url, le lien de déblocage du compte

​

Variables du modèle de courriel de changement de mot de passe (code)

• code, le code de changement de mot de passe

​

Variables du modèle de courriel pour le lien de changement de mot de passe

• url, le lien de réinitialisation du mot de passe

​

Variables du modèle de courriel d’inscription à l’AMF

• link, le lien d’inscription à l’AMF.

​

Variables du modèle de courriel Passwordless OTP

• send, avec une valeur de link, link_ios, link_android ou code, selon le type de courriel Passwordless demandé
• code, avec le code à usage unique pour accéder à l’application
• link, avec le lien sur lequel l’utilisateur peut cliquer pour accéder à l’application (uniquement pour les courriels Passwordless de type lien)
• operation, avec une valeur de change_email pour une opération de changement de courriel Passwordless

​

Variables du modèle de courriel d’invitation d’un utilisateur

• inviter.name
• roles.id
• roles.name
• roles.description

​

Variables du modèle du courriel de vérification (code)

• code, le code de vérification

​

Variables du modèle du courriel de vérification (lien)

• url, le lien de vérification