La fonction .variable() permet de définir des variables personnalisées, que vous pouvez ensuite réutiliser dans vos textes de paywalls.

Cela facilite la mise à jour automatique de certains éléments, selon les informations passées dans votre configuration technique.

Créez vos propres variables

Pour aller encore plus loin dans l'utilisation des variables, vous pouvez créer les vôtres et les utiliser de la même façon que les variables natives.

Pour ce faire, votre équipe technique devra créer côté code les dites variables (ne vous inquiétez pas c'est très simple) 👉 Documentation Technique

Une fois les variables créées, vous n'aurez plus qu'à récupérer auprès de votre équipe technique les noms des variables et vous pourrez ensuite les utiliser à votre guise dans vos textes.

Cas d’usage : la gestion multi-langue

Dans un contexte multi-langue, cette fonction peut être utilisée pour afficher automatiquement les textes dans la bonne langue, selon la locale de l’utilisateur.

La détection de la langue est gérée côté technique : vous n’avez donc rien à paramétrer dans le Dashboard.

Exemple de configuration technique

L’équipe technique prépare au préalable les textes par langue :

const texts = {   
   "fr": { article: "Article offert" },  
   "en": { article: "Free article" },  
   "es": { article: "Artículo gratuito" }  
};

Ensuite, selon la langue détectée (locale), la variable personnalisée est définie avec la valeur correspondante :

engage.variables('article', texts[locale].article);

Utilisation dans le Dashboard

Une fois la variable définie côté technique, vous pouvez simplement l’utiliser dans votre élément :

{article}

Le texte affiché s’adaptera automatiquement à la langue de l’utilisateur :

• 🇫🇷 Utilisateur en français → Article offert
• 🇬🇧 Utilisateur en anglais → Free article
• 🇪🇸 Utilisateur en espagnol → Artículo gratuito

Exemple

Voici un exemple d’un élément entièrement construit avec des variables dynamiques.

[](https://downloads.intercomcdn.com/i/o/s22rivig/1769706810/f27297a6daa81f94a31ce7922b44/image.png?expires=1773413100&signature=52d2ea4888e607da3c2d81487fdb7ba16eef61e64edad23b001e63bbbbb3df77&req=dSchH85%2Bm4leWfMW1HO4zT9DdGuPTWg9Cij9E0%2F9gENfx4Iy0WW9ob0bjL8v%0AWAvbh7APeS34MfbL5EU%3D%0A)

Dans cet exemple, toutes les parties textes sont des variables.

Au final, tout est géré via le multi-langue, et il n’y a aucun texte en dur, ni dans l’apparence ni dans l’élément.

Dans ce cas d’utilisation, les variables sont définies côté technique.

Cela signifie que dans la preview du Dashboard, les textes associés à ces variables ne seront pas remplacés automatiquement.

Vous verrez donc encore le texte entre accolades, comme {article}. Sur votre site final (ou en environnement de préproduction), la variable sera correctement remplacée par la traduction correspondant à la langue de l’utilisateur.

Liens utiles vers la doc technique:

• 📘 Documentation Poool Engage — Variables

Mis à jour le : 30/03/2026