Recommandez Lyvora à votre réseau et touchez jusqu’à 20 % de commission. Apport d’affaires : jusqu’à 20 %. Découvrir l’apport d’affaires

Écrire sur WhatsApp

Réponses générées par une IA (Mistral) à partir des pages du site. N’indiquez pas d’informations personnelles. Confidentialité

Assistant

Réserver un appel

Réponses générées par une IA (Mistral) à partir des pages du site. N’indiquez pas d’informations personnelles. Confidentialité

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
  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 Claude Perplexity

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

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>

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

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

É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 studioInstagram

Partager