> ## Documentation Index > Fetch the complete documentation index at: https://help.hiredata.com/llms.txt > Use this file to discover all available pages before exploring further. # Variables > Personnalisez un e-mail HireData avec des variables : le sélecteur, où elles fonctionnent dans un e-mail, ajouter les vôtres, lier des enregistrements, et ce qu'un destinataire voit quand une valeur manque. Une variable est un espace réservé que HireData remplit au moment où l'e-mail part. Écrivez `{{recipient.first_name}}` une fois et chaque destinataire lit son propre nom. L'éditeur d'e-mails affiche une variable sous forme de badge portant son libellé, pas sa valeur. `{{recipient.first_name}}` s'affiche **Recipient: First Name** dans le canevas, et le badge se comporte comme un objet unique plutôt que comme les caractères qu'il remplace. Survolez-le pour voir la valeur qu'il contient. Voir [Variables](/fr/variables/introduction) pour le badge, son popover et la façon de le modifier. ## Insérer une variable Tapez `{{` et un sélecteur s'ouvre sous le curseur. Chaque ligne donne le libellé de la variable, sa `{{key}}` et le type de valeur qu'elle contient. Continuez à taper pour affiner la liste. La recherche est indulgente. Tapez `frist` et **Recipient: First Name** apparaît quand même. Le champ Subject avec un badge de variable et un jeton partiellement tapé à la fin, et le sélecteur en dessous listant Recipient: Last Name et Sender: Last Name avec leurs clés et leurs types Appuyez sur Entrée ou cliquez sur une ligne et le jeton se transforme en badge. Vous pouvez aussi taper l'expression entière à la main, modificateurs compris. Elle devient un badge dès que vous tapez les `}}` de fermeture. ## Où les variables fonctionnent Partout où vous pouvez taper dans un e-mail, et à plusieurs endroits où vous ne pouvez pas. * Le champ **Subject**, qui est la ligne qu'un destinataire lit dans sa boîte de réception. * Le texte d'un [Paragraph](/fr/reference/email-builder/blocks/paragraph) et d'un [Heading](/fr/reference/email-builder/blocks/heading). * L'adresse d'un lien. Sélectionnez du texte, cliquez sur le bouton de lien dans le menu contextuel, et la fenêtre propose un menu déroulant de chaque variable contenant une URL, y compris `{{template::unsubscribe_url}}`. * Le champ **URL** d'un [Button](/fr/reference/email-builder/blocks/button) et de chaque ligne d'un [Social](/fr/reference/email-builder/blocks/socials). * Une image. L'onglet **Fields** de la médiathèque liste les variables qui portent une image, pour le bloc [Image](/fr/reference/email-builder/blocks/image) comme pour la [Signature](/fr/reference/email-builder/blocks/signature). * Une couleur. Les commandes de couleur choisissent parmi les variables de couleur de la marque par leur nom, ce que signifie « Theme: Palette Primary Color ». Voir [Marque, thème et métadonnées](/fr/reference/email-builder/template#brand-theme-and-metadata). ## La liste des variables Le bouton aux accolades dans la barre d'outils ouvre **Variables**, un panneau listant tout ce que cet e-mail peut utiliser. Recherchez par libellé ou par clé. Quand HireData connaît déjà une valeur, la carte l'affiche, donc vous pouvez distinguer `{{brand.name}}` de `{{account.name}}` sans deviner. Les variables que vous avez ajoutées vous-même figurent en haut, chacune marquée d'une étincelle, et le sélecteur `{{` place les mêmes en premier. Cliquez sur l'une d'elles pour rouvrir ses paramètres. Le panneau Variables avec un champ de recherche et un bouton plus, listant trois variables propres au modèle marquées d'une étincelle au-dessus de Template unsubscribe_url, Template Subject, Template Form URL et Brand Id, chacune avec sa clé, son type et sa valeur ## Ajouter votre propre variable Le **+** à côté du champ de recherche ouvre un dialogue **Variables** : vos **Fields** à gauche, et à droite les types au choix, en six groupes. Ils vont de **Text**, **Number** et **Yes / No** en passant par **Email**, **Phone** et **Address** jusqu'à **Color**, **Font** et **JSON**. **Search types** affine la liste. Le sélecteur de type dans le dialogue Variables, avec un champ Search types au-dessus de groupes intitulés Intelligent, Basics, Date and time, People and places, Web and media et Advanced Choisissez un type et quatre paramètres s'ouvrent à côté. * **Name** est ce que le badge affiche dans le canevas. * **Default value** est ce que HireData écrit quand rien d'autre ne fournit de valeur. La commande correspond au type que vous avez choisi. * **Reference as** est la clé que vous tapez entre les accolades. Elle se remplit d'elle-même à partir du nom. * **What is it for?** est une note facultative pour la personne qui ouvrira le modèle après vous. **Save changes** les conserve. Une variable que vous ajoutez appartient à cet e-mail seul, alors faites **Save** sur le modèle avant de partir. Le dialogue Variables avec une liste Fields contenant AI variable, Phone et ID, et les paramètres de Phone ouverts sur Name, Default value, Reference as et What is it for, au-dessus de Cancel et Save changes Une variable à vous prouve son utilité quand une même valeur a sa place à plusieurs endroits. Mettez votre numéro de téléphone dans une variable `{{phone}}` et écrivez-la dans la signature, le pied de page et le corps, et changer le numéro ensuite est une seule modification au lieu de trois. Supprimer une variable ne la retire pas de l'e-mail. Chaque badge qui l'utilisait devient orange, et la clé part avec ses accolades visibles. Supprimez la variable, puis retrouvez chaque badge orange et retirez-le ou remplacez-le. **AI variable** est le premier type du dialogue. Plutôt que de chercher une valeur, il en calcule une pour chaque destinataire à partir d'une instruction que vous rédigez. Voir [Variables IA](/fr/variables/ai-variables).

Récupérer les champs d'un enregistrement

Le bouton en forme de base de données dans la barre d'outils ouvre **Objects**, qui lie un type d'enregistrement à l'e-mail : un candidat, un poste, un match. Liez-en un et chaque champ de cet enregistrement rejoint la liste des variables, adressé par la clé de l'objet, comme dans `{{candidate.first_name}}`. [Objets](/fr/reference/forms/objects) explique ce qu'est un objet et ce que le lier fait. La page est écrite pour l'éditeur de formulaires, qui propose plus de paramètres par objet, mais les enregistrements et leurs clés sont les mêmes.

Valeurs manquantes

Trois choses peuvent arriver à une variable au moment où l'e-mail part, et une seule est celle que vous vouliez. * **La variable se résout.** HireData a une valeur et l'écrit. * **La variable se résout en rien.** Le destinataire n'a pas de numéro de téléphone enregistré, donc `{{recipient.phone_number}}` sort comme un espace vide. « Appelez-nous au . » est la façon classique dont cela se manifeste. * **La variable n'existe pas.** HireData laisse une clé qu'il ne reconnaît pas exactement telle que vous l'avez tapée. Le destinataire lit `{{recipient.favourite_biscuit}}`, accolades comprises. L'éditeur vous dit vers lequel des trois vous vous dirigez. Survolez un badge pour voir la valeur qu'il contient, et guettez un badge orange, qui est une clé que HireData ne reconnaît pas. Ajoutez un modificateur `default` pour couvrir les deuxième et troisième cas avec vos propres mots. [Variables](/fr/variables/introduction) explique le badge et son popover, et [Modificateurs](/fr/variables/modifiers#valeur-de-repli) explique la valeur de repli. Un jeton collé depuis ailleurs est la source habituelle du troisième cas. Collez-le, puis vérifiez que le badge n'est pas orange. ## Voir aussi * [Tester](/fr/reference/email-builder/testing) est l'endroit où découvrir en quoi vos variables se résolvent. * [Variables](/fr/variables/introduction) couvre la syntaxe `{{ }}`, le badge et son popover dans les formulaires, les messages et les automatisations comme dans l'e-mail. * [Modificateurs](/fr/variables/modifiers) liste tout ce que vous pouvez faire à une valeur en route vers l'e-mail. * [Variables IA](/fr/variables/ai-variables) calculent une valeur par destinataire au lieu d'en chercher une. * [Objets](/fr/reference/forms/objects) couvre les enregistrements dont les champs deviennent des variables. * [Traductions](/fr/reference/email-builder/translations) garde vos variables intactes dans chaque langue. ## Related topics - [Variables](/fr/variables/introduction.md) - [Variables IA](/fr/variables/ai-variables.md) - [Comment fonctionnent les modèles WhatsApp](/fr/apps/messaging/whatsapp/how-whatsapp-templates-work.md) - [Test & Evaluate](/fr/reference/forms/testing/test-and-evaluate.md) - [Configurer un formulaire par enregistrement](/fr/content/configuring-a-form-per-record.md)