---
title: "Aide-mémoire Liquid : objets, balises et filtres Shopify — Lyvora"
description: "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."
url: "https://www.lyvora.agency/blog/academie/aide-memoire-liquid"
lang: "fr-FR"
---

[Académie · Liquid](https://www.lyvora.agency/blog/academie) 5 min de lecturePublié le 4 novembre 2026

# 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](https://www.lyvora.agency/blog/academie/liquid-shopify)

**Outils**

[référence Liquid de Shopify](https://shopify.dev/docs/api/liquid)

[**Ylan Colson**Fondateur de Lyvora](https://www.lyvora.agency/agence)

[Partager sur LinkedIn](https://www.linkedin.com/sharing/share-offsite/?url=https%3A%2F%2Fwww.lyvora.agency%2Fblog%2Facademie%2Faide-memoire-liquid) [Partager sur X](https://x.com/intent/post?url=https%3A%2F%2Fwww.lyvora.agency%2Fblog%2Facademie%2Faide-memoire-liquid&text=Aide-m%C3%A9moire+Liquid%C2%A0%3A+objets%2C+balises+et+filtres+Shopify)

**Sommaire5 parties**

1. Étape 1 — Repérer les objets de l'aide-mémoire Liquid
2. Étape 2 — Écrire la logique avec les balises
3. Étape 3 — Transformer les valeurs avec les filtres Liquid
4. Étape 4 — Tester une condition sans surprise
5. Questions fréquentes

## 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 : `product` sur une fiche, `collection` sur une collection.
- Les filtres s'enchaînent de gauche à droite.
- Seuls `false` et `nil` sont faux : une chaîne vide est vraie, d'où le test `!= blank`.

Résumer avec [ChatGPT](https://chatgpt.com/?q=R%C3%A9sume+cet+article+%3A+https%3A%2F%2Fwww.lyvora.agency%2Fblog%2Facademie%2Faide-memoire-liquid) [Claude](https://claude.ai/new?q=R%C3%A9sume+cet+article+%3A+https%3A%2F%2Fwww.lyvora.agency%2Fblog%2Facademie%2Faide-memoire-liquid) [Perplexity](https://www.perplexity.ai/search?q=R%C3%A9sume+cet+article+%3A+https%3A%2F%2Fwww.lyvora.agency%2Fblog%2Facademie%2Faide-memoire-liquid)

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](https://shopify.dev/docs/api/liquid), 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](https://www.lyvora.agency/blog/academie/liquid-shopify), puis le comparatif sur le [thème Shopify sur mesure](https://www.lyvora.agency/blog/comparatifs/theme-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 |
| --- | --- | --- |
| `shop` | Partout | `{{ shop.name }}` |
| `settings` | Partout | `{{ settings.logo }}`, réglages du thème |
| `cart` | Partout | `{{ cart.item_count }}` |
| `customer` | Partout, si le client est connecté | `{{ customer.first_name }}` |
| `routes` | Partout | `{{ routes.cart_url }}` |
| `request` | Partout | `{{ request.page_type }}` |
| `product` | Fiche produit | `{{ product.title }}`, `{{ product.price }}` |
| `collection` | Page de collection | `{{ collection.products_count }}` |
| `section`, `block` | Dans une section, un bloc | `{{ section.settings.titre }}` |

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 |
| --- | --- | --- |
| `if`, `elsif`, `else`, `unless` | Condition | `{% if product.available %}` |
| `case`, `when` | Plusieurs cas d'une même valeur | `{% case product.type %}` |
| `for`, `break`, `continue` | Boucle, avec `limit`, `offset`, `reversed` | `{% for p in collection.products limit: 4 %}` |
| `assign`, `capture` | Variable simple, variable de texte | `{% assign total = 0 %}` |
| `liquid`, `echo` | Plusieurs balises sans délimiteurs | `{% liquid assign a = 1 %}` |
| `render` | Insérer un snippet | `{% render 'badge', product: product %}` |
| `comment`, `raw` | Note invisible, texte non interprété | `{% comment %}…{% endcomment %}` |
| `style`, `stylesheet`, `javascript` | CSS et JS d'une section | `{% stylesheet %}` |
| `schema` | Réglages d'une section | `{% schema %}` |
| `form`, `paginate` | Formulaires Shopify, pagination | `{% form 'product', product %}` |

Les balises `case` et `capture` évitent bien des conditions imbriquées :

Liquid

```
{%- 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>
```

Le service

Design UI/UX Shopify

Une interface Shopify dessinée pour votre marque et pour votre catalogue.

[Découvrir le service](https://www.lyvora.agency/design-ui-ux-shopify)[Voir une boutique livrée](https://www.lyvora.agency/maison-trungadi)[Recevoir une estimation écrite](https://www.lyvora.agency/contact?parcours=estimation&prestation=design-ui-ux#contact)

## Étape 3 : Transformer les valeurs avec les filtres Liquid

Un filtre suit une barre verticale, et plusieurs filtres s'appliquent de gauche à droite.

![Aide-mémoire Liquid : un titre passe par downcase, replace puis prepend, chaque filtre partant du résultat précédent.](https://www.lyvora.agency/media/site/95f83928-782b-4f56-860c-5dfbb7c87b89/aide-memoire-liquid-chaine-filtres-evv3ef.avif?width=1080&quality=85&resize=contain)

Lisez une chaîne de filtres comme une recette : chaque étape part du résultat de la précédente.

| Famille | Filtres | Exemple |
| --- | --- | --- |
| Texte | `upcase`, `downcase`, `capitalize`, `strip`, `truncate`, `replace`, `remove`, `append`, `prepend`, `split` | `{{ product.title \| truncate: 40 }}` |
| HTML | `escape`, `strip_html`, `newline_to_br`, `link_to` | `{{ product.description \| strip_html }}` |
| Nombre | `plus`, `minus`, `times`, `divided_by`, `round`, `at_least`, `at_most` | `{{ 3 \| times: 2 }}` |
| Liste | `size`, `first`, `last`, `join`, `map`, `where`, `sort`, `uniq`, `compact` | `{{ product.tags \| join: ', ' }}` |
| Prix | `money`, `money_without_trailing_zeros`, `money_with_currency` | `{{ product.price \| money }}` |
| Médias | `image_url`, `image_tag`, `asset_url`, `stylesheet_tag` | `{{ product.featured_image \| image_url: width: 600 \| image_tag }}` |
| Divers | `date`, `default`, `json`, `t`, `handleize`, `metafield_tag` | `{{ article.published_at \| date: '%d/%m/%Y' }}` |

![Trois petits tamis en porcelaine blanche empilés, une bille bleue posée dans le dernier.](https://www.lyvora.agency/media/site/95f83928-782b-4f56-860c-5dfbb7c87b89/aide-memoire-liquid-illustration-lg8p2e.webp?width=1080&quality=85&resize=contain)

Filtrer une liste, c'est la passer au tamis : where ne garde que les produits qui remplissent la condition.

Deux combinaisons reviennent sans cesse : filtrer une liste, puis en extraire une propriété.

Liquid

```
{%- 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.

![Aide-mémoire Liquid : seuls false et nil sont faux ; chaîne vide, zéro et liste vide sont vrais.](https://www.lyvora.agency/media/site/95f83928-782b-4f56-860c-5dfbb7c87b89/aide-memoire-liquid-vrai-faux-6zdv7h.avif?width=1080&quality=85&resize=contain)

Une description vide passe un simple if : pour l'écarter, comparez-la à blank.

Liquid

```
{%- 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

- L'objet utilisé existe sur la page modifiée
- Les prix passent par `money`
- Les valeurs saisies par les équipes passent par `escape`
- Les valeurs qui peuvent manquer sont testées avec `!= blank`
- Les conditions qui mêlent `and` et `or` sont découpées

À 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](https://www.lyvora.agency/blog/academie/section-personnalisee-shopify) ou affichez vos [champs méta](https://www.lyvora.agency/blog/academie/metafields-shopify).

É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](https://www.lyvora.agency/blog/guides/design-system-e-commerce). Vous voulez un thème Shopify écrit pour votre catalogue ? Notre page [création de boutique Shopify](https://www.lyvora.agency/creation-boutique-shopify) présente notre façon de travailler ; pour en parler, [écrivez-nous](https://www.lyvora.agency/contact).

Votre projet

Un site Shopify ou Webcosa à concevoir ?

Parlez-nous de votre marque, de votre catalogue et de votre calendrier. Le premier échange est un appel de 30 minutes, par téléphone, à l’heure de Paris.

[Recevoir une estimation écrite](https://www.lyvora.agency/contact?parcours=estimation&prestation=design-ui-ux#contact)[Réserver un appel de 30 min](https://www.lyvora.agency/contact?parcours=appel&prestation=design-ui-ux#contact)

[Design UI/UX Shopify](https://www.lyvora.agency/design-ui-ux-shopify)[Voir une boutique livrée](https://www.lyvora.agency/maison-trungadi)

## 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.

Écrit par

Ylan ColsonFondateur de Lyvora

Ylan Colson a fondé Lyvora à Paris en 2024. Le studio conçoit et développe des sites vitrines et e‑commerce sur‑mesure, sur Shopify et sur Webcosa.

[Le studio](https://www.lyvora.agency/agence)[Instagram](https://www.instagram.com/ylan.ecom/)

Partager[Partager sur LinkedIn](https://www.linkedin.com/sharing/share-offsite/?url=https%3A%2F%2Fwww.lyvora.agency%2Fblog%2Facademie%2Faide-memoire-liquid) [Partager sur X](https://x.com/intent/post?url=https%3A%2F%2Fwww.lyvora.agency%2Fblog%2Facademie%2Faide-memoire-liquid&text=Aide-m%C3%A9moire+Liquid%C2%A0%3A+objets%2C+balises+et+filtres+Shopify)

Un projet Shopify ou Webcosa ?

Vous échangez directement avec l’équipe qui conçoit et développe votre site.

[Réserver un appel de 30 min](https://www.lyvora.agency/contact?parcours=appel&prestation=design-ui-ux#contact) [contact@lyvora.agency](mailto:contact@lyvora.agency)

Nos réalisations

## Des boutiques livrées par le studio

[Toutes les réalisations](https://www.lyvora.agency/realisations)

- [![Colliers Mayalice portés : rang de perles et chaîne dorée à breloques, sur un haut en crochet écru](https://www.lyvora.agency/media/site/95f83928-782b-4f56-860c-5dfbb7c87b89/mayalice-couverture-irysok.avif?width=960&quality=85&resize=contain)Bijoux personnalisésRefonte · ShopifyMayaliceRefonte luxe minimaliste et six configurateurs produits pour composer son bijou en direct.](https://www.lyvora.agency/mayalice)
- [![Peignoir Nouvelle Vague crème de Maison Trungadi porté en extérieur, dans la verdure](https://www.lyvora.agency/media/site/95f83928-782b-4f56-860c-5dfbb7c87b89/maison-trungadi-couverture-qympx5.avif?width=960&quality=85&resize=contain)Linge de bainMigration et refonte · ShopifyMaison TrungadiPeignoirs et linge de bain confectionnés en Toscane : une boutique à la hauteur des matières.](https://www.lyvora.agency/maison-trungadi)
- [![Bougie artisanale Candle’lice tenue en main au-dessus d’une planche en bois parsemée de guimauves](https://www.lyvora.agency/media/site/95f83928-782b-4f56-860c-5dfbb7c87b89/candlelice-couverture-207lru.avif?width=960&quality=85&resize=contain)Bougies artisanalesMigration et refonte · ShopifyCandle’liceDes bougies atypiques coulées à la main en France, sorties d’une plateforme qui les bridait.](https://www.lyvora.agency/candlelice)

## Tutoriels voisins

[Tous les tutoriels](https://www.lyvora.agency/blog/academie)

- [Sur le même sujet Liquid Shopify : lire et modifier un thème pas à pas](https://www.lyvora.agency/blog/academie/liquid-shopify)
- [Académie · 4 novembre 2026 Traduire une boutique Shopify avec Translate & Adapt](https://www.lyvora.agency/blog/academie/traduire-boutique-shopify)
- [Académie · 4 novembre 2026 FAQ schema : ajouter le balisage FAQPage sur Shopify](https://www.lyvora.agency/blog/academie/faq-schema-shopify)
