Metafields et métaobjets Shopify : le guide d'usage, avec des projets réels

Ce guide est informatif. Pour faire concevoir ou intégrer ces modèles dans un thème, la page développement Shopify Liquid décrit notre intervention, et le dossier Liquid et performance regroupe les articles voisins. Ici, on répond à trois questions : que choisir, comment le définir, et à quoi cela ressemble dans de vraies boutiques.

La différence en une phrase

Selon la documentation Shopify, un metafield est « un champ supplémentaire sur une ressource existante », et un métaobjet « un nouveau type d'enregistrement que vous définissez ». Le premier prolonge un produit, une variante, une collection, une page, une commande ou un client. Le second crée un objet autonome, avec son identifiant et ses champs, qu'on rattache ensuite à d'autres ressources.

Les deux fonctionnent ensemble. Shopify indique que la plupart des applications utilisent les deux : le métaobjet décrit l'enregistrement (par exemple un ingrédient), et un metafield le relie aux produits concernés. Cette combinaison évite de recopier la même information sur cinquante fiches : on corrige l'entrée une fois, toutes les fiches suivent.

Définir avant de remplir

Chaque champ démarre par une définition : un nom, un espace de noms, un type et des règles de validation. Dans l'administration, les définitions se créent dans Paramètres, Données personnalisées ; les entrées des métaobjets se gèrent dans Contenu, Métaobjets.

Une définition apporte trois choses concrètes. Le champ obtient un éditeur adapté à son type (sélecteur de produit, saisie avec unité, case à cocher). Les valeurs sont validées à l'écriture. Enfin, le champ devient recherchable et filtrable. Sans définition, Shopify stocke une chaîne de texte simple que personne ne peut valider ni filtrer : c'est la première source de catalogues désordonnés.

Le choix du type est la décision qui coûte le plus cher à corriger. Voici la correspondance que nous appliquons, d'après la liste officielle des types.

Certains types n'ont pas de version liste : boolean, id, json, language, money, multi_line_text_field et rich_text_field. Si vous avez besoin de plusieurs paragraphes enrichis, il faut passer par un métaobjet.

Cas 1 : un rituel proposé sur chaque fiche (On The Wild Side)

Sur les fiches de la marque de soins On The Wild Side, une routine est proposée sous les bénéfices, avec son prix et un bouton « Ajouter ». L'étude de cas précise qu'elle est pilotée par un champ personnalisé : chaque produit connaît son rituel associé, sans page à construire à la main.

L'intérêt est double. L'équipe de la marque modifie le rituel d'un produit dans l'administration, sans toucher au thème. Et la même structure se répète sur toutes les fiches, ce qui garde la page lisible. Le bon type pour ce besoin est une référence de produit : le lien suit le produit même si son titre change. Nous détaillons le rôle de ce bloc dans la conversion dans l'article sur la fiche produit sur mobile.

Cas 2 : relier les pages d'un marché à l'autre (Nutripure)

Nutripure vend en France sur nutripure.fr et développe l'Italie et l'Espagne sur nutripure.com, avec deux catalogues distincts à maintenir. L'audit technique a relevé plus de 230 annotations hreflang parasites et des x-default pointant vers des URL inexistantes. La réponse livrée repose sur des métachamps : une correspondance Italie / Espagne renseignée produit par produit, lue par un composant hreflang du thème, avec une règle simple : aucun alternate n'est généré sans équivalent renseigné.

La règle à retenir dépasse le cas : un champ vide ne doit produire aucun balisage. Un composant qui imprime un lien alternatif par défaut crée exactement les erreurs que le projet cherchait à supprimer. Ce cas concerne deux domaines distincts ; pour un marché géré dans une seule boutique avec Shopify Markets, la checklist SEO international reste la référence, car Shopify y gère les hreflang automatiquement. Le détail du projet est dans l'étude de cas Nutripure.

Cas 3 : un catalogue assaini avant de chercher la croissance (ShopDermoPro)

ShopDermoPro vend des pigments, des dermographes, des accessoires et des formations, en français, anglais et espagnol. Au fil des ajouts, des types de produit, des rattachements de collections, des métachamps et des traductions ne décrivaient plus correctement l'offre. Le lot livré le 5 septembre 2026 a corrigé les données ciblées, avec ces volumes publiés dans l'étude de cas :

Un principe a guidé le lot : corriger uniquement ce qui pouvait être relié à une source existante. Les contenances, usages techniques et compatibilités encore incertains sont restés en attente de notices fabricant, plutôt que complétés par supposition. Des champs typés rendent cette discipline possible : une contenance enregistrée en volume peut être validée, une valeur manquante reste visible comme manquante. Le même raisonnement vaut pour les produits cosmétiques, détaillé dans l'article sur la fiche produit cosmétique.

Cas 4 : ce qu'il ne faut pas mettre dans un metafield (MagicBeez)

MagicBeez vend des packs de tickets pour les commerces, avec un parcours d'activation géré dans un autre environnement. Les préférences de campagne choisies par le client sont transmises avec la commande, selon l'étude de cas. Cette donnée a une particularité : c'est le visiteur qui la saisit, au moment de l'achat. Elle n'appartient donc pas à un metafield, que le marchand renseigne en amont, mais aux propriétés de ligne ou aux attributs de panier, qui voyagent avec la commande.

Pour une saisie faite par le client lui-même (prénom à broder, message, préférence), l'outil adapté est la propriété de ligne de commande, expliquée avec le code dans le guide du produit personnalisable sur Shopify.

Afficher un metafield dans le thème

Deux chemins existent. Si votre thème prend en charge les sources dynamiques, vous reliez la plupart des champs depuis l'éditeur de thème, sans code. Sinon, ou pour un type que le thème ne gère pas, vous modifiez le code. En Liquid, la valeur d'un champ se lit ainsi :

{{ product.metafields.custom.benefits.value }}

Pour un champ de type liste, la valeur est un tableau qu'on parcourt avec une boucle ; pour une référence de métaobjet, on lit ensuite les champs de l'entrée référencée. Retenez un point de référencement : Google ne lit que ce qui sort dans le HTML rendu. Un metafield rempli mais jamais affiché n'aide ni les visiteurs ni le SEO. S'il doit aussi alimenter des données structurées, la méthode est dans le guide des données structurées Shopify.

Six erreurs que nous corrigeons le plus souvent

1. Pas de définition. Une valeur sans définition est un texte libre : impossible à valider, à rechercher ou à filtrer.
2. Un champ « fourre-tout » en JSON. Il se lit mal dans l'administration et se casse à la première modification manuelle.
3. Des noms incohérents. Un même usage nommé de trois façons selon les produits rend les boucles du thème fragiles.
4. Des traductions oubliées. Sur une boutique multilingue, chaque valeur texte doit exister dans chaque langue : le lot ShopDermoPro compte 656 traductions ciblées.
5. Une donnée privée dans un champ exposé. Les définitions règlent les accès, notamment à l'API Storefront : vérifiez-les avant d'y mettre une information interne.
6. Un champ vide qui produit du balisage. Le cas Nutripure le montre : sans valeur, rien ne doit être imprimé.

Plan de mise en place en cinq étapes

1. Listez les informations qui se répètent sur vos fiches ou vos pages (bénéfices, contenance, ingrédients, rituel associé).
2. Séparez ce qui est propre à un produit (metafield) de ce qui est partagé (métaobjet).
3. Créez chaque définition avec le type le plus précis possible et des règles de validation.
4. Reliez les champs au thème par les sources dynamiques, ou par Liquid pour les cas particuliers.
5. Contrôlez le rendu sur trois produits (un simple, un à variantes, un sans valeur) avant de remplir tout le catalogue.

Questions fréquentes

Quelle est la différence entre un metafield et un métaobjet ?

Un metafield ajoute un champ à une ressource existante, comme un produit. Un métaobjet est un nouveau type d'enregistrement que vous définissez, avec plusieurs champs, et que d'autres ressources peuvent référencer.

Où créer un metafield dans l'administration Shopify ?

Dans Paramètres, puis Données personnalisées, où l'on crée la définition (nom, espace de noms, type, validation). Les valeurs se saisissent ensuite sur chaque produit, collection ou page.

Peut-on afficher un metafield sans écrire de code ?

Oui, si le thème prend en charge les sources dynamiques : vous reliez le champ à un bloc depuis l'éditeur de thème. Avec un thème ancien ou un type de champ non géré, il faut modifier le code du thème.

Google lit-il les metafields d'une boutique Shopify ?

Seulement ce qui est affiché dans le HTML de la page ou repris dans les données structurées. Un champ renseigné mais absent du rendu reste invisible pour les moteurs de recherche.

Peut-on avoir plusieurs valeurs dans un même metafield ?

Oui, avec un type liste, préfixé list. (par exemple list.single_line_text_field). Les valeurs sont stockées dans un tableau JSON. Les types boolean, json, money, multi_line_text_field et rich_text_field n'ont pas de version liste.

Comment remplir des metafields pour tout un catalogue ?

Par l'API GraphQL Admin, ou avec un outil d'import qui gère les métachamps. Dans tous les cas, testez d'abord sur un petit lot et relisez les valeurs après écriture, comme nous l'avons fait sur les 231 métachamps du lot ShopDermoPro.

Continuer avec EXPERAISE

• Développement Shopify Liquid
• Thème Shopify sur mesure
• API Shopify et intégrations
• Guides Liquid et performance
• Étude de cas Nutripure

---

Sources officielles

• Shopify : données personnalisées (metafields et métaobjets)
• Shopify : liste des types de données de metafields
• Shopify : métaobjets
• Centre d'aide Shopify : métaobjets
• Centre d'aide Shopify : metafields

Données de projet : études de cas publiées On The Wild Side, Nutripure (audit technique de janvier 2026, livrables du thème V1.2), ShopDermoPro (lot du 05/09/2026) et MagicBeez. Aucun chiffre de vente ou de trafic n'est attribué à ces interventions.