> ## Documentation Index
> Fetch the complete documentation index at: https://translations.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# 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](https://liquidjs.com/tutorials/intro-to-liquid.html). 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.

<div id="tags">
  ## Balises
</div>

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](https://liquidjs.com/tags/overview.html).

<div id="debug-tag">
  ### balise debug
</div>

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.

<div id="filters">
  ## Filtres
</div>

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](https://liquidjs.com/filters/overview.html).

<div id="general-variables">
  ## Variables générales
</div>

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`

<Warning>
  - Dans le modèle de courriel d’inscription à l’AMF, la variable `connection.name` n’est pas disponible.
</Warning>

* Renseignements liés au tenant définis dans [Tenant Settings](https://manage.auth0.com/#/tenant) :
  * `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

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

* Lorsqu’un utilisateur ouvre une session par l’entremise d’une [Organization](/docs/fr-ca/manage-users/organizations/organizations-overview), 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 <Tooltip tip="Custom Domain : domaine de tierce partie avec un nom spécialisé ou personnalisé." cta="Voir le glossaire" href="/docs/fr-ca/glossary?term=custom+domains">domaines personnalisés</Tooltip> 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](/docs/fr-ca/customize/custom-domains/multiple-custom-domains), 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é :

```liquid theme={null}
{% 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 :

```liquid theme={null}
{% 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](/docs/fr-ca/customize/custom-domains)
2. activé **Use Custom Domain in Emails** dans **Dashboard** > **Branding** > **Custom Domains**
3. défini un [domaine personnalisé par défaut](/docs/fr-ca/customize/custom-domains/multiple-custom-domains/default-domain) si vous utilisez plusieurs domaines personnalisés

<div id="redirect-to-variables">
  ### Variables de Redirect To
</div>

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

<Callout icon="file-lines" color="#0EA5E9" iconType="regular">
  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](/docs/fr-ca/customize/email/email-templates/customize-email-templates#url-lifetime-and-redirect-to).
</Callout>

* `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`.

<div id="template-specific-variables">
  ## Variables propres aux modèles
</div>

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

<div id="blocked-account-email-template-variables">
  ### Variables du modèle de courriel pour un compte bloqué
</div>

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

<div id="change-password-code-email-template-variables">
  ### Variables du modèle de courriel de changement de mot de passe (code)
</div>

* `code`, le code de changement de mot de passe

<div id="change-password-link-email-template-variables">
  ### Variables du modèle de courriel pour le lien de changement de mot de passe
</div>

* `url`, le lien de réinitialisation du mot de passe

<div id="mfa-enrollment-email-template-variables">
  ### Variables du modèle de courriel d’inscription à l’AMF
</div>

* `link`, le lien d’inscription à l’AMF.

<div id="passwordless-otp-email-template-variables">
  ### Variables du modèle de courriel Passwordless OTP
</div>

* `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

<div id="user-invitation-email-template-variables">
  ### Variables du modèle de courriel d’invitation d’un utilisateur
</div>

* `inviter.name`
* `roles.id`
* `roles.name`
* `roles.description`

<div id="verification-email-code-template-variables">
  ### Variables du modèle du courriel de vérification (code)
</div>

* `code`, le code de vérification

<div id="verification-email-link-template-variables">
  ### Variables du modèle du courriel de vérification (lien)
</div>

* `url`, le lien de vérification