---
title: "Liquid Shopify : lire et modifier un thème pas à pas — Lyvora"
description: "Liquid Shopify expliqué pas à pas : objets, filtres et balises, où se trouve le code du thème et comment faire une première modification sans risque."
url: "https://www.lyvora.agency/blog/academie/liquid-shopify"
lang: "fr-FR"
---

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

# Liquid Shopify : lire et modifier un thème pas à pas

Liquid Shopify expliqué pas à pas : objets, filtres et balises, où se trouve le code du thème et comment faire une première modification sans risque.

**Niveau**

Débutant

**Durée**

45 min

**Prérequis**

un accès « Modifier le code » au thème, une copie du thème publié

**Outils**

[référence Liquid de Shopify](https://shopify.dev/docs/api/liquid), l'éditeur de code de l'administration

[**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%2Fliquid-shopify) [Partager sur X](https://x.com/intent/post?url=https%3A%2F%2Fwww.lyvora.agency%2Fblog%2Facademie%2Fliquid-shopify&text=Liquid+Shopify%C2%A0%3A+lire+et+modifier+un+th%C3%A8me+pas+%C3%A0+pas)

**Sommaire6 parties**

1. Avant de commencer
2. Étape 1 — Ouvrir le code Liquid de votre thème Shopify
3. Étape 2 — Lire une ligne de Liquid
4. Étape 3 — Parcourir une liste avec une boucle
5. Étape 4 — Faire une première modification sur la copie
6. Questions fréquentes

## L'essentiel

- Liquid est le langage de gabarit des thèmes Shopify : il insère les données de la boutique dans le HTML.
- Trois syntaxes suffisent pour lire un thème : les objets `{{ }}`, les filtres `|` et les balises `{% %}`.
- Le code se trouve dans Boutique en ligne › Thèmes › Modifier le code, rangé en dossiers.
- On modifie toujours une copie du thème, jamais le thème publié.

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

Liquid Shopify est le langage qui transforme les fichiers d'un thème en pages : il lit les données de la boutique (produits, prix, collections) et les place dans le HTML envoyé au navigateur. Savoir lire Liquid permet de comprendre ce que fait un thème et d'y faire de petites modifications sans application. Pour décider s'il vaut mieux retoucher un thème existant ou en faire créer un, lisez d'abord notre comparatif sur le [thème Shopify sur mesure](https://www.lyvora.agency/blog/comparatifs/theme-shopify-sur-mesure).

_Code vérifié le 7 novembre 2026 avec Shopify Theme Check ; parcours relevés dans l'aide Shopify. À tester sur une boutique de développement avant la mise en ligne._

## Avant de commencer

[Liquid](https://github.com/Shopify/liquid) est un langage open source créé par Shopify. Il ne sert pas à programmer une application : il sert à afficher. Un fichier `.liquid` contient du HTML ordinaire, dans lequel des marqueurs Liquid sont remplacés par des valeurs au moment où Shopify construit la page. Le client ne voit jamais le code Liquid, seulement le résultat.

Liquid connaît trois syntaxes, et elles suffisent pour lire un thème entier.

| Syntaxe | Rôle | Exemple |
| --- | --- | --- |
| `{{ … }}` objet | Affiche une donnée | `{{ product.title }}` |
| `\|` filtre | Transforme la donnée affichée | `{{ product.price \| money }}` |
| `{% … %}` balise | Logique : condition, boucle, variable | `{% if product.available %}` |
| `{%- … -%}` | Même balise, sans les espaces autour | `{%- assign v = 1 -%}` |

![Un pochoir blanc à formes géométriques posé à plat, un petit rouleau encreur bleu à côté.](https://www.lyvora.agency/media/site/95f83928-782b-4f56-860c-5dfbb7c87b89/liquid-shopify-illustration-9txot3.webp?width=1080&quality=85&resize=contain)

Un thème Liquid fonctionne comme un pochoir : la forme est fixe, les données de la boutique viennent la remplir.

## Étape 1 : Ouvrir le code Liquid de votre thème Shopify

Dans l'administration Shopify, ouvrez Boutique en ligne › Thèmes. Sur le thème publié, cliquez sur le bouton « … » pour ouvrir le menu d'actions et choisissez « Dupliquer » : vous travaillerez sur cette copie. Sur la copie, ouvrez le même menu, puis « Modifier le code ». Une boutique compte au plus 20 thèmes : au-delà, il faut en supprimer un avant de dupliquer.

L'éditeur affiche les dossiers du thème, toujours les mêmes d'un thème à l'autre, comme le décrit la [documentation sur l'architecture des thèmes](https://shopify.dev/docs/storefronts/themes/architecture).

| Dossier | Ce qu'il contient | Exemple dans Dawn |
| --- | --- | --- |
| `layout` | Le cadre commun à toutes les pages | `theme.liquid` |
| `templates` | Un modèle par type de page, en JSON | `product.json` |
| `sections` | Les blocs de page que l'éditeur déplace | `main-product.liquid` |
| `blocks` | Les blocs de thème réutilisables (Horizon) | `price.liquid` |
| `snippets` | Les morceaux de code partagés | `card-product.liquid` |
| `assets`, `config`, `locales` | CSS et JS, réglages, traductions | `base.css`, `fr.json` |

Résultat attendu

Vous voyez la liste des dossiers et vous travaillez sur la copie : son nom commence par « Copie de ».

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 2 : Lire une ligne de Liquid

Ouvrez `snippets/card-product.liquid` (Dawn) ou le fichier de la carte produit de votre thème. Vous y trouverez des lignes de ce genre :

Liquid

```
{%- if product.available -%}
  <p class="prix">{{ product.price | money }}</p>
{%- else -%}
  <p class="prix">Épuisé</p>
{%- endif -%}
```

Lisez-la de gauche à droite. `product` est l'objet du produit affiché ; `product.price` est son prix, en centimes ; le filtre `money` le met au format de la devise de la boutique. La balise `if` choisit ce qui s'affiche : le prix si le produit est disponible, « Épuisé » sinon.

![Schéma des trois syntaxes du Liquid Shopify : objet entre doubles accolades, filtre après une barre verticale, balise entre accolades et signes pour cent.](https://www.lyvora.agency/media/site/95f83928-782b-4f56-860c-5dfbb7c87b89/liquid-shopify-trois-syntaxes-pl2ram.avif?width=1080&quality=85&resize=contain)

Un objet affiche, un filtre transforme, une balise décide : le reste n'est que du HTML.

Bon à savoir

Un objet n'existe que là où Shopify le fournit. `product` est disponible sur une fiche produit et dans une carte produit ; sur la page d'accueil, il faut passer par une collection ou par un réglage de section.

## Étape 3 : Parcourir une liste avec une boucle

La balise `for` répète un morceau de HTML pour chaque élément d'une liste. Voici les quatre premiers produits d'une collection, avec leur prix barré quand il existe :

Liquid

```
<ul class="selection">
  {%- for item in collection.products limit: 4 -%}
    <li>
      <a href="{{ item.url }}">{{ item.title | escape }}</a>
      {%- if item.compare_at_price > item.price -%}
        <s>{{ item.compare_at_price | money }}</s>
      {%- endif %}
      {{ item.price | money }}
    </li>
  {%- else -%}
    <li>Aucun produit dans cette collection.</li>
  {%- endfor -%}
</ul>
```

Le paramètre `limit` borne la boucle ; la branche `else` s'affiche quand la liste est vide. Le filtre `escape` protège le HTML si un titre contient un caractère spécial.

## Étape 4 : Faire une première modification sur la copie

Exemple construit : vous voulez un message sous le prix des produits portant l'étiquette `fait-main`. Dans le fichier de la fiche produit de votre copie (`sections/main-product.liquid` sur Dawn), ajoutez ce code juste après le bloc du prix :

Liquid

```
{%- comment -%} Message pour les produits étiquetés fait-main {%- endcomment -%}
{%- if product.tags contains 'fait-main' -%}
  {%- assign delai = 'Fabriqué à la commande' -%}
  <p class="mention-atelier">{{ delai }} dans notre atelier.</p>
{%- endif -%}
```

`contains` cherche l'étiquette dans la liste `product.tags` ; `assign` crée une variable ; `comment` laisse une note que le client ne verra pas. Enregistrez, puis ouvrez l'aperçu de la copie sur un produit qui porte l'étiquette, et sur un autre qui ne la porte pas.

![Fiche produit de la boutique Shopify Candle'lice sur ordinateur : titre, prix, mention fait main et bouton d'ajout au panier.](https://www.lyvora.agency/media/site/95f83928-782b-4f56-860c-5dfbb7c87b89/ab-testing-shopify-guide-fiche-candlelice-mkxio0.avif?width=1080&quality=85&resize=contain)

Sur une fiche Shopify comme celle de Candle'lice, le titre, le prix et le bouton d'achat sont des objets Liquid placés dans le HTML du thème.

Résultat attendu

Le message apparaît sur le produit étiqueté `fait-main`, et nulle part ailleurs. L'étiquette doit être écrite exactement de la même façon : `contains` distingue les majuscules.

Attention

Selon l'aide Shopify, si vos modifications du code sont incompatibles avec une mise à jour du thème, toutes sont supprimées dans la copie mise à jour : notez chaque fichier touché, ou placez vos ajouts dans un snippet à part. Pour un ajout de quelques lignes, le [bloc Liquid personnalisé](https://www.lyvora.agency/blog/academie/custom-liquid-shopify) de l'éditeur évite de toucher aux fichiers.

Check-list

- Le thème publié a une copie de sauvegarde
- La modification est faite sur la copie
- Le résultat est vérifié dans l'aperçu, sur deux produits
- Les fichiers modifiés sont notés
- La copie est publiée seulement après vérification

Pour la suite, gardez l'[aide-mémoire Liquid](https://www.lyvora.agency/blog/academie/aide-memoire-liquid) ouvert à côté de l'éditeur, puis passez à la [création d'une section personnalisée](https://www.lyvora.agency/blog/academie/section-personnalisee-shopify).

Retoucher quelques lignes de Liquid est à la portée d'un marchand attentif ; un thème construit autour de votre catalogue est un autre chantier, que nous comparons aux thèmes du marché dans [comment choisir un thème Shopify](https://www.lyvora.agency/blog/guides/theme-shopify-comment-choisir). Vous envisagez un thème sur mesure ? 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

**### Liquid est-il un langage de programmation ?**

Non, pas au sens d'un langage d'application. Liquid est un langage de gabarit : il affiche des données, applique des conditions et des boucles, mais il ne peut ni enregistrer une commande ni appeler un service externe. Pour la logique de paiement, de remise ou de livraison, Shopify passe par les applications et Shopify Functions, pas par Liquid.

**### Faut-il savoir coder pour modifier un thème Shopify ?**

Cela dépend de la modification. L'éditeur de thème change les textes, les couleurs et l'ordre des sections sans une ligne de code. Liquid devient utile pour afficher une donnée que le thème ignore, comme une étiquette ou un champ méta. Des notions de HTML et de CSS suffisent pour les retouches courantes.

**### Liquid fonctionne-t-il en dehors de Shopify ?**

Oui. Liquid est open source et sert aussi à d'autres outils, comme le générateur de sites Jekyll. Les objets propres aux boutiques (`product`, `cart`, `collection`) et des filtres comme `money` ou `image_url` n'existent en revanche que sur Shopify : un code de thème ne se copie pas tel quel ailleurs.

**### Où trouver la liste complète des objets et des filtres Liquid ?**

Dans la référence Liquid de Shopify, sur shopify.dev, qui décrit chaque objet, filtre et balise avec un exemple. Notre aide-mémoire Liquid en reprend l'essentiel en tableaux, rangé par usage, pour retrouver vite la syntaxe pendant une modification de thème.

É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%2Fliquid-shopify) [Partager sur X](https://x.com/intent/post?url=https%3A%2F%2Fwww.lyvora.agency%2Fblog%2Facademie%2Fliquid-shopify&text=Liquid+Shopify%C2%A0%3A+lire+et+modifier+un+th%C3%A8me+pas+%C3%A0+pas)

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 Custom Liquid Shopify : les usages sûrs du bloc](https://www.lyvora.agency/blog/academie/custom-liquid-shopify)
- [Académie · 4 novembre 2026 Export comptable Shopify et facturation électronique](https://www.lyvora.agency/blog/academie/export-comptable-shopify)
- [Académie · 4 novembre 2026 Créer et importer des redirections 301 dans Shopify](https://www.lyvora.agency/blog/academie/redirections-shopify)
