Académie · Liquid 5 min de lecturePublié le
Aide-mémoire Liquid : objets, balises et filtres Shopify
Aide-mémoire Liquid pour Shopify : les objets par page, les balises de logique et de thème, les filtres utiles et les conditions, en tableaux.
- Niveau
- Intermédiaire
- Durée
- 15 min
- Prérequis
- les bases de Liquid

Sommaire5 parties
L'essentiel
Cet aide-mémoire Liquid range en tableaux la syntaxe la plus utilisée dans un thème Shopify.
Les objets disponibles dépendent de la page :
productsur une fiche,collectionsur une collection.Les filtres s'enchaînent de gauche à droite.
Seuls
falseetnilsont faux : une chaîne vide est vraie, d'où le test!= blank.
Cet aide-mémoire Liquid rassemble, en tableaux, les objets, balises, filtres et opérateurs qui reviennent dans presque tous les thèmes Shopify, avec un exemple court pour chacun. Il ne remplace pas la référence Liquid de Shopify, qui décrit chaque propriété ; il sert à retrouver une syntaxe en quelques secondes pendant une modification. Si vous débutez, lisez d'abord le tutoriel sur les bases du Liquid Shopify, puis le comparatif sur le thème Shopify sur mesure pour savoir jusqu'où pousser les retouches.
Syntaxe vérifiée le 7 novembre 2026 dans la référence Liquid de Shopify ; exemples rendus avec LiquidJS.
Étape 1 : Repérer les objets de l'aide-mémoire Liquid
Un objet affiche une donnée entre {{ }}. Les objets globaux existent partout ; les autres, seulement sur la page qui les porte.
Objet | Disponible | Exemple |
|---|---|---|
| Partout |
|
| Partout |
|
| Partout |
|
| Partout, si le client est connecté |
|
| Partout |
|
| Partout |
|
| Fiche produit |
|
| Page de collection |
|
| Dans une section, un bloc |
|
Bon à savoir
Les prix sont en centimes : product.price vaut 2190 pour 21,90 €. Passez toujours par un filtre money pour les afficher.
Étape 2 : Écrire la logique avec les balises
Une balise s'écrit entre {% %} et n'affiche rien par elle-même.
Balise | Usage | Exemple |
|---|---|---|
| Condition |
|
| Plusieurs cas d'une même valeur |
|
| Boucle, avec |
|
| Variable simple, variable de texte |
|
| Plusieurs balises sans délimiteurs |
|
| Insérer un snippet |
|
| Note invisible, texte non interprété |
|
| CSS et JS d'une section |
|
| Réglages d'une section |
|
| Formulaires Shopify, pagination |
|
Les balises case et capture évitent bien des conditions imbriquées :
{%- capture libelle -%}
{%- case product.type -%}
{%- when 'Bougie' -%}Durée de combustion indiquée sur l'étiquette
{%- when 'Diffuseur' -%}Recharge vendue séparément
{%- else -%}Fabriqué dans notre atelier
{%- endcase -%}
{%- endcapture -%}
<p class="mention">{{ libelle | strip }}</p>
Étape 3 : Transformer les valeurs avec les filtres Liquid
Un filtre suit une barre verticale, et plusieurs filtres s'appliquent de gauche à droite.

Famille | Filtres | Exemple |
|---|---|---|
Texte |
|
|
HTML |
|
|
Nombre |
|
|
Liste |
|
|
Prix |
|
|
Médias |
|
|
Divers |
|
|

Deux combinaisons reviennent sans cesse : filtrer une liste, puis en extraire une propriété.
{%- assign dispo = collection.products | where: 'available' -%}
<p>{{ dispo.size }} produits disponibles sur {{ collection.products.size }}.</p>
<p>Marques : {{ dispo | map: 'vendor' | uniq | join: ', ' | default: 'aucune' }}</p>
Étape 4 : Tester une condition sans surprise
Liquid compare avec ==, !=, >, <, >=, <=, et contains pour une chaîne ou une liste de chaînes. On combine avec and et or, sans parenthèses : Liquid évalue les opérateurs de droite à gauche.

{%- if product.description != blank and product.tags contains 'fiche-complete' -%}
<div class="description">{{ product.description }}</div>
{%- elsif product.description != blank -%}
<div class="description">{{ product.description | strip_html | truncate: 160 }}</div>
{%- endif -%}
Attention
{% if a or b and c %} se lit a or (b and c), puisque Liquid commence par la droite. Quand une condition mêle and et or, découpez-la en deux if imbriqués.
Résultat attendu
Une fiche dont la description est vide n'affiche aucun bloc ; une fiche étiquetée fiche-complete affiche la description entière, les autres un extrait de 160 signes.
Check-list
À retenir
Trois signes, {{ }}, | et {% %}, une règle de vérité, et la référence de Shopify pour le reste. Pour mettre cet aide-mémoire en pratique, construisez une section personnalisée ou affichez vos champs méta.
Écrire du Liquid juste est une chose ; savoir ce qu'un thème doit faire en est une autre, comme le montre notre guide sur le design system d'une boutique e-commerce. Vous voulez un thème Shopify écrit pour votre catalogue ? Notre page création de boutique Shopify présente notre façon de travailler ; pour en parler, écrivez-nous.
Questions fréquentes
Quelle différence entre assign et capture en Liquid ?
assign crée une variable à partir d'une valeur ou d'un filtre, sur une ligne : {% assign prix = product.price | money %}. capture enregistre tout ce qui se trouve entre ses deux balises, HTML et Liquid compris, sous forme de texte. On choisit capture pour assembler un libellé ou un morceau de HTML, assign pour le reste.
Pourquoi mon if est-il vrai alors que le champ est vide ?
Parce qu'en Liquid, une chaîne vide est vraie : seuls false et nil sont faux. Un champ rempli puis vidé contient souvent une chaîne vide, et {% if champ %} passe. Comparez plutôt à blank : {% if champ != blank %} écarte la valeur absente, la chaîne vide et la liste vide.
Peut-on utiliser des parenthèses dans une condition Liquid ?
Non. Liquid n'accepte pas de parenthèses dans une condition et évalue les opérateurs and et or de droite à gauche. Pour une logique à plusieurs niveaux, imbriquez deux balises if, ou calculez d'abord un résultat intermédiaire avec assign, puis testez cette variable.
Les filtres Liquid de Shopify marchent-ils ailleurs ?
En partie. Les filtres de texte, de nombre et de liste font partie du Liquid open source et existent dans d'autres outils. Les filtres propres aux boutiques, comme money, image_url, asset_url ou metafield_tag, n'existent que dans les thèmes Shopify.
Nos réalisations
Des boutiques livrées par le studio
Bijoux personnalisésRefonte · ShopifyMayaliceRefonte luxe minimaliste et six configurateurs produits pour composer son bijou en direct.
Linge de bainMigration et refonte · ShopifyMaison TrungadiPeignoirs et linge de bain confectionnés en Toscane : une boutique à la hauteur des matières.
Bougies artisanalesMigration et refonte · ShopifyCandle’liceDes bougies atypiques coulées à la main en France, sorties d’une plateforme qui les bridait.





