Aller au contenu
Docs

Référence

Temple insère variables, valeurs par défaut et conditions dans l’objet, le HTML et le texte des e-mails au moment de l’envoi. Syntaxe, valeurs vraies et fausses, échappement et contextes où Temple s’exécute.

Mis à jour le 20 oct. 2026

Temple est le petit langage de templates d’Emailit pour les lignes d’objet, le HTML et le texte brut. Ce n’est ni Liquid ni Handlebars : il prend en charge les variables, les chemins imbriqués, les valeurs par défaut et les blocs if/else, et rien d’autre. Les modèles stockent les variables telles que vous les écrivez, et Temple les remplit quand un e-mail est envoyé via l’API, par une automatisation ou par une campagne.

Syntaxe en bref

Text
{{first_name}}                      Variable
{{user.name}}   {{items.0.sku}}     Nested property and list item
{{first_name|"there"}}              Default when the value is missing or null
{{#if plan}} … {{else}} … {{/if}}   Conditional, with an optional else

Temple n’a ni boucles, ni filtres, ni helpers, ni partials, ni fonctions personnalisées. Le seul opérateur est |, pour la valeur par défaut.

Variables

Text
Hello {{first_name}}
  • Temple remplace {{first_name}} par la valeur first_name que vous fournissez. Les espaces à l’intérieur des accolades sont ignorés : {{ first_name }} fonctionne donc aussi.
  • Les noms sont sensibles à la casse : {{First_Name}} ne correspond pas à first_name.
  • Une valeur manquante ou null devient une chaîne vide. Les variables inconnues disparaissent au lieu d’apparaître dans l’e-mail.
  • Les valeurs sont converties en texte. Les nombres et les booléens apparaissent tels quels (42, true), et les listes sont jointes par des virgules (["a","b"] devient a,b). Un objet s’affiche sous la forme [object Object] : ciblez plutôt l’un de ses champs.

Propriétés imbriquées et éléments de liste

Utilisez des points pour accéder à l’intérieur des objets, et des nombres pour les positions dans une liste, à partir de 0 :

Text
{{user.name}}
{{order.items.0.sku}}
JSON
{
  "user": { "name": "Ada" },
  "order": { "items": [{ "sku": "A1" }, { "sku": "B7" }] }
}

Comme le point sépare les segments du chemin, une clé qui contient elle-même un point est inaccessible. Utilisez des clés sans point.

Valeurs par défaut

Ajoutez | suivi d’une valeur de repli à utiliser quand la valeur est manquante ou null :

Text
Hi {{first_name|"there"}},
Your company: {{company|'Not set'}}

Les guillemets doubles, les guillemets simples ou l’absence de guillemets fonctionnent tous. La valeur par défaut n’est pas utilisée pour une chaîne vide, 0 ou false : ces valeurs s’affichent respectivement vide, 0 et false. Une valeur par défaut ne peut pas contenir le caractère }.

Conditions

Text
{{#if plan}}
Thanks for being on the {{plan}} plan.
{{else}}
You're on the free plan. Upgrade anytime from your dashboard.
{{/if}}
  • {{else}} est facultatif.
  • Une condition est fausse quand la valeur est manquante, null, false, 0, une chaîne vide "" ou une liste vide []. Tout le reste est vrai, y compris la chaîne "0", la chaîne "false" et un objet vide.
  • Une condition est un unique chemin de variable, comme plan ou user.is_admin. Il n’existe ni ==, ni and, or, not ou unless. Pour créer une branche selon une valeur, calculez un booléen dans votre code et transmettez-le, par exemple "is_pro": true.
  • Écrivez {{else}} et {{/if}} exactement comme indiqué, sans espace à l’intérieur des accolades.
  • Temple traite d’abord les conditions, puis les variables.

Les blocs peuvent être imbriqués. Temple résout d’abord les blocs les plus intérieurs : chaque {{else}} et chaque {{/if}} appartient donc à son propre {{#if}} :

Text
{{#if plan}}
  {{#if annual}}Billed yearly.{{else}}Billed monthly.{{/if}}
{{else}}
  You're on the free plan.
{{/if}}

L’imbrication fonctionne jusqu’à 10 niveaux de profondeur.

Échappement et caractères spéciaux

Les valeurs ne sont pas échappées en HTML. Temple insère les valeurs exactement telles que vous les transmettez. Une valeur comme Tom & Jerry ou <b>Ada</b> est insérée telle quelle dans le HTML : échappez donc dans votre code tout texte fourni par l’utilisateur avant de le transmettre. Les mêmes variables remplissent l’objet, le HTML et le texte : une valeur échappée comme Tom &amp; Jerry apparaît donc aussi sous cette forme dans l’objet et le texte. Si c’est gênant, transmettez une variable distincte, échappée, pour le HTML.

Cela signifie aussi que vous pouvez transmettre du HTML tout prêt, comme un tableau de lignes de commande généré par votre code, dans une seule variable.

Il n’existe pas de syntaxe d’échappement pour les doubles accolades. Temple considère tout ce qui se trouve entre {{ et }} comme une variable et le supprime en l’absence de valeur. Les accolades simples, comme celles du CSS, ne sont pas concernées. Les valeurs sont insérées une seule fois et ne sont pas réanalysées : pour afficher des doubles accolades littérales, placez-les dans une variable :

JSON
{
  "html": "<p>Write {{example}} in your template to show the first name.</p>",
  "variables": { "example": "{{first_name}}" }
}

Où Temple s’exécute

Contexte Temple s’exécute ? Ce que vous pouvez utiliser
API e-mail avec un template Toujours Les variables que vous transmettez, et global
API e-mail avec un subject, un html ou un text direct Quand variables contient au moins une clé, ou que le contenu utilise {{global.…}} Les variables que vous transmettez, et global
Automatisations, étape Send email À chaque envoi Les champs du contact, tags, score, contact, global, unsubscribe_url, manage_subscriptions_url, payload, meta, run, automation et step, plus email dans les automatisations Email. Voir E-mails des automatisations.
Campagnes, envois de test et Preview as contact Toujours Les champs du contact, cf, custom_fields, tags, score, global, unsubscribe_url, manage_subscriptions_url, webview_url et contact. Voir Campagnes.
Relais SMTP Non Rien. Le message est envoyé tel que vous l’avez construit.
Éditeurs du tableau de bord et leurs aperçus Non Les éditeurs insèrent les variables, et leurs aperçus les affichent sans rendu. Les éditeurs MJML (alpha) proposent aussi un aperçu de Temple avec des données d’exemple. Pour voir le rendu d’une campagne pour un contact donné, utilisez Preview as contact.

E-mails envoyés via l’API

Transmettez l’alias d’un modèle ou un ID tem_, ainsi qu’un objet variables. Les champs que vous envoyez dans la requête (subject, html, text) remplacent ceux du modèle, puis Temple effectue le rendu de l’objet, du HTML et du texte.

JSON
{
  "from": "Acme <hello@acme.com>",
  "to": "ada@example.com",
  "template": "welcome-email",
  "variables": {
    "first_name": "Ada",
    "plan": "Pro",
    "activation_url": "https://acme.com/activate?token=8f3k2",
    "cf": { "company": "Analytical Engines Ltd" }
  }
}

Les éditeurs du tableau de bord insèrent {{cf.<key>}} pour les champs personnalisés des contacts. Lors des envois via l’API, rien n’est récupéré depuis vos contacts : fournissez donc vous-même ces valeurs sous cf, comme dans l’exemple. Il en va de même pour {{unsubscribe_url}} : transmettez votre propre lien de désinscription si le modèle l’utilise. Les valeurs globales font exception : {{global.<key>}} est rempli à partir de l’espace de travail, sauf si vos variables ont leur propre clé global.

Vous pouvez aussi envoyer du contenu direct avec variables, sans modèle. Consultez Envoyer un e-mail.

E-mails des automatisations

À chaque envoi, l’étape Send email effectue le rendu de l’objet, du HTML et du texte avec Temple, qu’ils proviennent du modèle ou de valeurs remplacées dans l’étape.

Les automatisations de contact placent les champs du contact au premier niveau : ces variables fonctionnent donc :

  • {{email}}, {{first_name}} et {{last_name}}
  • {{cf.<key>}} ou {{custom_fields.<key>}} pour les champs personnalisés, par exemple {{cf.plan}}. {{cf.<key>}} est la forme qu’utilisent les campagnes et les éditeurs.
  • {{tags}}, les tags du contact sous la forme vip, customer, et {{#if tags}}…{{/if}} ; {{score}}, le score de lead
  • {{unsubscribe_url}}, le lien de désinscription du contact, également envoyé sous forme d’en-têtes List-Unsubscribe en un clic dans les e-mails marketing, et {{manage_subscriptions_url}}, sa page de gestion des abonnements
  • {{contact.*}}, le même contact sous forme d’objet, par exemple {{contact.first_name}}

Toutes les automatisations disposent aussi de {{global.*}}, les valeurs globales de l’espace de travail, de {{payload.*}}, les données de l’événement qui a déclenché l’exécution, et de {{meta.*}}, les métadonnées de l’exécution. Elles disposent aussi de {{run.id}}, {{automation.id}}, {{automation.name}} et {{step.key}}, la clé de l’étape Send email. Les automatisations Email ajoutent {{email.*}}, l’e-mail qui a démarré l’exécution, par exemple {{email.mail_from}}. Les automatisations Email et event n’ont pas de contact au premier niveau : utilisez {{payload.*}} ou définissez le destinataire et l’objet dans l’étape.

Campagnes

Les campagnes effectuent le rendu de l’objet, du HTML et du texte avec Temple pour chaque destinataire, quel que soit l’éditeur utilisé pour les créer. Les envois de test et Preview as contact effectuent le rendu de la même façon. Les variables proviennent du contact destinataire :

  • {{first_name}}, {{last_name}} et {{email}}
  • {{unsubscribe_url}}, le lien de désinscription du destinataire, et {{manage_subscriptions_url}}, sa page de gestion des abonnements
  • {{cf.<key>}} ou {{custom_fields.<key>}} pour les champs personnalisés, par exemple {{cf.plan}}
  • {{tags}}, les tags du contact sous la forme vip, customer, et {{score}}, le score de lead
  • {{global.<key>}}, une valeur globale, par exemple {{global.offer_url}}
  • {{contact.*}}, les mêmes champs sous forme d’objet, par exemple {{contact.first_name}}

Les champs vides du contact comptent comme manquants, et les valeurs par défaut s’appliquent donc : {{first_name|"there"}} donne there pour un contact sans prénom. Les envois de test à une adresse qui appartient à un contact de l’espace de travail utilisent les données de ce contact. Pour les autres adresses, {{email}} est rempli avec l’adresse de test et les noms et les champs personnalisés restent vides.

Les balises de fusion de campagne écrites avant que les campagnes n’utilisent Temple continuent de fonctionner. Les noms first_name, last_name, email et unsubscribe_url, ainsi que le préfixe cf., correspondent quelle que soit la casse : {{FIRST_NAME}} fonctionne donc toujours. Les clés des champs personnalisés doivent correspondre exactement. Consultez Balises de fusion des campagnes.

SMTP

Le relais SMTP accepte un message terminé. Il n’y a ni recherche de modèle ni passage de Temple : construisez donc le HTML final avant d’envoyer, ou utilisez l’API ou une automatisation si vous avez besoin de variables.

Vérifier les modèles avant de les publier

Emailit ne rejette ni un modèle ni un envoi à cause d’une syntaxe Temple incorrecte. Les erreurs se traduisent généralement par du texte manquant ou des accolades restantes dans l’e-mail livré. Les modèles MJML (alpha) font exception : leur enregistrement vérifie leur syntaxe Temple et rejette les blocs non équilibrés. Avant de publier :

  • Vérifiez que chaque {{#if …}} a son {{/if}} correspondant, et que chaque {{ a son }} fermant.
  • Envoyez-vous la version brouillon par son ID tem_ avec des variables réalistes, y compris des valeurs manquantes et vides, pour voir les deux branches de chaque condition. Consultez Versions de modèle.
  • Pour une campagne, utilisez Preview as contact avec des contacts qui ont chaque valeur et d’autres qui ne l’ont pas, puis envoyez un test. Consultez Tester et programmer.

Exemples

Une formule d’accueil avec une valeur de repli :

Text
Hi {{first_name|"there"}},

Un bloc qui dépend du forfait :

Text
{{#if plan}}
Your plan: {{plan}}
{{else}}
Upgrade anytime from your dashboard.
{{/if}}

Un objet avec une valeur imbriquée :

Text
Order {{order.number}} has shipped, {{user.first_name|"friend"}}

Cette page vous a-t-elle été utile ?

Merci pour votre retour.

Merci, nous lisons chaque message.