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

# Personnalisation

> Variables, conditions et boucles pour écrire à chacun.

Le contenu et l'objet acceptent des **variables** entre doubles accolades, et un petit langage de **conditions** et de **boucles**. Aucun code n'est exécuté : le moteur ne comprend que ce qui est décrit ici.

Le bouton **Variables** de chaque éditeur liste celles qui sont disponibles ; un clic copie la variable.

## Variables

### Dans les campagnes et les automatisations

| Variable                                        | Valeur                                                   |
| ----------------------------------------------- | -------------------------------------------------------- |
| `{{ subscriber.first_name }}`                   | Prénom                                                   |
| `{{ subscriber.last_name }}`                    | Nom                                                      |
| `{{ subscriber.email }}`                        | Adresse e-mail                                           |
| `{{ subscriber.attributes.ville }}`             | Un attribut personnalisé (remplacez `ville`)             |
| `{{ list.name }}`                               | Nom de la liste                                          |
| `{{ unsubscribe_url }}`                         | Lien de désabonnement                                    |
| `{{ preferences_url }}`                         | Lien vers la page de préférences                         |
| `{{ organisation.address }}`                    | Adresse postale de l'organisation (Paramètres → Général) |
| `{{ webview_url }}`                             | Lien vers la version web                                 |
| `{{ campaign.name }}`, `{{ campaign.subject }}` | Campagnes : nom et objet                                 |
| `{{ mail.name }}`, `{{ mail.subject }}`         | E-mails d'automatisation : nom et objet                  |

### Dans les e-mails de confirmation et de bienvenue

Les mêmes variables d'abonné et de liste, plus `{{ confirm_url }}`, le lien de confirmation.

### Dans les e-mails transactionnels

Les variables sont celles que votre application envoie. Avec :

```json theme={null}
{ "customer": { "name": "Ada" }, "order": { "number": "A-1024", "paid": true } }
```

vous écrivez `{{ customer.name }}` et `{{ order.number }}`. Voir [E-mails transactionnels par l'API](/fr/developers/transactional).

<Note>
  Une variable inconnue ou vide est remplacée par une chaîne vide. Les valeurs sont échappées dans le HTML : un prénom qui contient `<script>` s'affiche tel quel, sans s'exécuter.
</Note>

## Conditions

```liquid theme={null}
{% if subscriber.first_name %}
  Bonjour {{ subscriber.first_name }},
{% else %}
  Bonjour,
{% endif %}
```

| Forme                            | Vraie quand                         |
| -------------------------------- | ----------------------------------- |
| `{% if nom %}`                   | la valeur est renseignée (non vide) |
| `{% if nom == "valeur" %}`       | égale, sans distinction de casse    |
| `{% if nom != "valeur" %}`       | différente                          |
| `{% if nom contains "valeur" %}` | contient le texte                   |
| `{% unless nom %}`               | l'inverse de `if`                   |

`{% else %}` est facultatif ; `if` se ferme par `{% endif %}`, `unless` par `{% endunless %}`.

```liquid theme={null}
{% if subscriber.attributes.formule == "pro" %}
  Merci d'être client Pro : la livraison est offerte.
{% endif %}
```

## Boucles

```liquid theme={null}
<ul>
{% for ligne in order.lines %}
  <li>{{ ligne }}</li>
{% endfor %}
</ul>
```

La boucle parcourt une **liste de valeurs simples** (`["Pain au levain", "Brioche"]`) ou un texte séparé par des virgules. Elle s'arrête à 500 éléments.

<Warning>
  Une boucle sur une liste d'objets (`[{"name": "Pain", "price": 3}]`) n'affiche pas `{{ ligne.name }}` : préparez côté application une liste de lignes déjà mises en forme, par exemple `"Pain au levain — 3 000 FCFA"`.
</Warning>

## Deux variables obligatoires

Une campagne ne part pas sans :

* **`{{ unsubscribe_url }}`** : un lien de désabonnement visible ;
* **`{{ organisation.address }}`** (ou l'adresse écrite en toutes lettres) : l'adresse postale de l'expéditeur.

Ce sont des obligations légales pour tout e-mail commercial. Le plus simple est de les placer dans votre [modèle](/fr/content/templates).