> For the complete documentation index, see [llms.txt](https://documentation.tousquali.fr/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://documentation.tousquali.fr/documents/06-variables-shortcodes.md).

# Les variables disponibles

Les **variables** sont des balises que tu insères dans tes modèles de documents. Au moment de la génération, TousQuali les remplace automatiquement par les vraies informations.

**Format** : toutes les variables s'écrivent entre crochets : `[nom_de_la_variable]`

***

## Variables disponibles

Les variables utilisables dans les modèles de documents sont les mêmes que celles disponibles dans les modèles d'emails : participant·e, session, OF, formateur·rice, client·e.

→ **Consulte la liste complète dans la section** [**Gestion des modèles d'emails**](/emails/03-templates-emails.md#variables-disponibles)

***

## Variables spécifiques aux documents

En plus des variables communes, les modèles de documents disposent de variables supplémentaires liées au document lui-même :

| Variable                  | Contenu                         |
| ------------------------- | ------------------------------- |
| `[document_name]`         | Nom du document                 |
| `[document_published_at]` | Date de publication du document |
| `[document_version]`      | Numéro de version               |

## Codes courts (liens)

Les codes courts génèrent des **liens cliquables** vers les espaces personnels. Ils sont disponibles dans les modèles de documents et d'emails.

| Code court               | Contenu                                             |
| ------------------------ | --------------------------------------------------- |
| `[entry_link]`           | Lien vers l'espace personnel du·de la participant·e |
| `[session_teacher_link]` | Lien vers l'espace formateur·rice de la session     |

***

## Exemple d'utilisation

```
CONTRAT DE FORMATION PROFESSIONNELLE

Entre :
[company_name], enregistré sous le numéro [company_nda_number],
SIRET : [company_company_id_number],
représenté par [company_administrator],

Et :
[entry_name], demeurant [entry_address],

Article 1 – Objet
Formation : [session_training]
Du [session_started_at] au [session_ended_at]
Durée : [session_nb_hours] heures ([session_nb_days] jours)
Lieu : [session_place_name]

Article 2 – Prix
Montant : [entry_price_ht] € HT
```

***

## Conseils

* **Variable vide** : si une variable ne trouve pas de valeur (ex : téléphone non renseigné), elle s'affiche vide dans le document. Vérifie que les fiches participant·e et session sont bien complètes avant de générer.
* **Tester** : utilise le bouton "Prévisualiser" pour vérifier que tes variables sont bien remplacées avant de publier le modèle.
* **Pastilles visuelles** : dans l'éditeur, les variables s'affichent sous forme de badges colorés pour les distinguer du texte normal. Elles ne peuvent pas être modifiées accidentellement — tu peux uniquement les supprimer et en insérer une nouvelle.