Shopify Metafields: Guide Complet de Configuration et d'Affichage

Un métachamp Shopify est un champ clé-valeur personnalisé que vous attachez à une ressource de votre boutique (produit, collection, commande, client, variante, et plus) pour stocker des données que le schéma natif de Shopify ne propose pas. Vous définissez le type de données, vous imposez la validation, puis vous affichez la valeur n'importe où: votre vitrine via Liquid, vos analyses via ShopifyQL, votre paiement via Shopify Functions, ou vos systèmes externes via l'API GraphQL Admin. Cette boucle en trois étapes (définir, remplir, afficher) constitue tout le modèle mental dont vous avez besoin.

Points clés à retenir

• Un métachamp est identifié par trois éléments: ressource propriétaire, namespace, et clé. Modifiez l'un de ces éléments et vous référencez un champ différent.
• Les Éditions Printemps '26 et Été '26 de Shopify ont apporté plusieurs améliorations aux métachamps: épinglez jusqu'à 50 champs sur les pages d'administration, des métachamps de panier qui se transfèrent aux commandes, des métachamps sur les transferts d'inventaire, et le filtrage par syntaxe pointée ShopifyQL.
• La version candidate de l'API GraphQL Admin 2026-07 vous permet de définir et de configurer les métachamps directement sur les transferts d'inventaire sans appel metafieldsSet séparé.
• Créer une définition n'affiche rien sur votre vitrine. Vous devez toujours connecter le champ via une source dynamique dans l'éditeur de thème, ou écrire le Liquid vous-même.
• Les définitions standard (instructions de soin, ingrédients, taille, ISBN, etc.) constituent la voie la plus rapide car elles sont préconfigurées, compatibles avec les thèmes, et interopérables avec les applications dès le départ.

Qu'est-ce exactement qu'un métachamp Shopify?

Les métachamps vous permettent de joindre des informations supplémentaires à une ressource Shopify, comme un produit ou une collection. Les données peuvent être des spécifications, des tableaux de tailles, des documents téléchargeables, des dates de sortie, des images ou des numéros de pièce. Chaque métachamp stocke une valeur accompagnée d'informations de type, et il est identifié par sa ressource propriétaire, son namespace et sa clé.

Pensez au namespace comme à un nom de dossier et à la clé comme au nom du fichier dans ce dossier. Un métachamp de produit avec namespace: custom et key: material est complètement séparé d'un autre avec namespace: specs et key: material, même s'ils vivent tous les deux sur le même produit.

Les trois modèles de propriété

Comprendre la propriété vous empêche de remplacer accidentellement des données que vous ne aviez pas l'intention de modifier.

Métachamps appartenant aux commerçants utilisent n'importe quel namespace non réservé (comme custom, specs, ou inventory). Toutes les applications installées peuvent les lire et les écrire. Ils sont idéaux pour les données partagées que plusieurs applications consomment.

Métachamps appartenant à une application utilisent le préfixe de namespace réservé $app. L'application propriétaire contrôle la structure et les valeurs, qui sont en lecture seule dans l'administration par défaut. Utilisez-les quand une application est la source faisant autorité pour une donnée.

Métachamps de données d'application sont liés à une installation d'application spécifique et sont complètement masqués à l'administration Shopify. Ils vivent sur la ressource AppInstallation et ne peuvent être accessibles que par l'application propriétaire via GraphQL ou via l'objet app dans Liquid. Ceux-ci sont pour l'état interne de l'application qui ne devrait jamais être visible aux commerçants.

Shopify maintient également des namespaces réservés par Shopify (préfixés shopify--) pour les champs gérés par la plateforme comme les définitions standard.

Types de données métachamps: un guide pratique

Shopify regroupe les types dans des catégories. Choisir le bon type est important car il impose la validation, contrôle comment Liquid rend la valeur, et détermine quels filtres s'appliquent.

Texte

• single_line_text_field, badges de produit, étiquettes courtes, codes ISO
• multi_line_text_field, listes d'ingrédients, instructions de soin (retours à la ligne conservés)
• rich_text, contenu long formaté (titres, gras, listes); rendez avec le filtre metafield_tag

Nombres et mesures

• number_integer, number_decimal
• dimension, volume, weight, chacun stocke une valeur numérique associée à une unité; idéal pour les spécifications de produits et les règles d'expédition

Dates et heures

• date, date_time, dates de lancement, dates d'expiration, calendriers d'événements

Références

• product_reference, collection_reference, page_reference, variant_reference, liez une ressource à une autre sans dupliquer les données
• metaobject_reference, lien vers une entrée métaobjet (voir ci-dessous)
• article_reference et list.article_reference, ajoutés dans la version de l'API 2025-10; vous permettent de lier directement les produits aux articles de blog pour le commerce piloté par le contenu et le référencement

Autres types utiles

• boolean, drapeaux de fonctionnalités, bascules « nouvelle arrivée », marqueurs de masquage à la vente
• color, valeurs de couleur basées sur hex avec support d'échantillons natifs
• url, file_reference, PDF téléchargeables, fiches techniques, vidéos
• json, données structurées arbitraires; utile mais plus difficile à valider et à rendre

Pour les types de liste, préfixez n'importe quel type scalaire avec list. (par exemple, list.single_line_text_field). Ceux-ci se rendent comme des tableaux dans Liquid et sont le bon choix chaque fois qu'un champ peut contenir plusieurs valeurs, comme une liste de matériaux ou un ensemble d'emplacements de retrait.

Une contrainte importante: lors de l'utilisation de l'API GraphQL Admin, la valeur du métachamp est toujours saisie et stockée sous forme de chaîne, quel que soit le type déclaré. Shopify gère la coercition de type à la lecture.

Définitions de métachamps: pourquoi elles sont importantes

Vous pouvez écrire un métachamp brut (sans définition) via l'API, mais les définitions sont presque toujours le bon choix. Une définition de métachamp établit un schéma que toutes les valeurs pour cette combinaison namespace-clé doivent respecter, y compris le type de données et les contraintes de validation. La définition contrôle également les autorisations d'accès via l'API GraphQL Admin, l'API Storefront, et l'API Customer Account, et détermine si le champ peut être utilisé pour le filtrage d'administrateur ou comme condition de collection.

Construire avec des définitions signifie:

• Support d'interface d'administration. Les champs définis apparaissent sur la page d'édition de chaque ressource pertinente sans aucun code personnalisé.
• Validation. Les valeurs invalides sont détectées avant de corrompre votre vitrine.
• Filtrage. Vous pouvez utiliser un champ défini comme condition de collection intelligente ou comme filtre d'administrateur.
• Découverte de l'éditeur de thème. Les sélecteurs de sources dynamiques ne proposent que les champs définis.

Les définitions standard sont des schémas prédéfinis pour les cas d'usage courants comme les numéros ISBN, les ingrédients de produits et les instructions de soin. Les utiliser signifie que les applications et les thèmes qui référencent ces namespaces standard sauront déjà comment lire vos données sans configuration supplémentaire.

Étape par étape: créer une définition et la remplir

Dans l'administration Shopify (sans code)

1. Allez à Paramètres > Données personnalisées.
2. Choisissez le type de ressource (Produits, Clients, Commandes, etc.).
3. Cliquez sur Ajouter une définition. Nommez-la, choisissez un type de contenu, et enregistrez.
4. Depuis l'Édition Printemps '26 de Shopify, vous pouvez également créer des métachamps directement à partir des pages de clients, commandes et collections sans naviguer d'abord vers Paramètres.
5. Ouvrez n'importe quel produit (ou autre ressource) et faites défiler jusqu'à la section Métachamps pour remplir les valeurs.

L'Édition Printemps '26 a également introduit la capacité à épingler jusqu'à 50 métachamps sur les sections de produits, clients et commandes afin que votre équipe puisse voir et modifier les champs les plus importants sans cliquer sur une page séparée.

Via l'API GraphQL Admin

Pour les opérations en masse ou les pipelines automatisés, utilisez metafieldDefinitionCreate (pour créer le schéma) suivi de metafieldsSet (pour écrire les valeurs). La mutation metafieldsSet permet un maximum de 25 métachamps par appel, avec une taille maximale de charge utile de demande totale de 10 MB, et l'opération est atomique: aucune modification n'est appliquée si une erreur se produit.

Une mutation de définition minimale ressemble à ceci:

mutation CreateMetafieldDefinition($definition: MetafieldDefinitionInput!) {
  metafieldDefinitionCreate(definition: $definition) {
    createdDefinition {
      id
      namespace
    }
    userErrors {
      field
      message
    }
  }
}

Avec variables:

{
  "definition": {
    "name": "Material",
    "namespace": "custom",
    "key": "material",
    "type": "list.single_line_text_field",
    "ownerType": "PRODUCT",
    "useAsCollectionCondition": true
  }
}

Définir useAsCollectionCondition: true signifie que vous pouvez immédiatement utiliser ce champ pour alimenter les règles de collection intelligente, aucune étape supplémentaire requise.

Pour les mises à jour de catalogue en masse, des outils comme Matrixify vous permettent d'importer des valeurs de métachamps à partir d'un CSV sans écrire aucun code d'API.

Afficher les métachamps sur votre vitrine

C'est là que la plupart des commerçants se bloquent. Créer la définition ne fait pas apparaître le champ sur votre vitrine. Vous devez le connecter.

Option 1: Sources dynamiques dans l'éditeur de thème (sans code)

Si vous êtes sur un thème compatible Online Store 2.0 (Dawn, Horizon, ou n'importe quel thème de modèle JSON), ouvrez l'éditeur de thème, ajoutez ou cliquez sur une section ou un bloc qui supporte les sources dynamiques, et cliquez sur l'icône connecter source dynamique. Vous pouvez ajouter jusqu'à 20 métachamps à un seul modèle de cette façon.

Option 2: Liquid (contrôle total)

La syntaxe Liquid est:

{{ product.metafields.namespace.key }}

Pour un métachamp de texte enrichi, utilisez le filtre metafield_tag pour rendre correctement le formatage HTML:

{{ product.metafields.custom.care_instructions | metafield_tag }}

Pour une référence de fichier image:

{{ product.metafields.custom.hero_image.value | image_url: width: 800 | image_tag }}

Une mise en garde: si votre clé de métachamp est size, first, ou last, utilisez plutôt la notation entre crochets que la notation pointée: product.metafields.namespace["size"]. Ces mots sont aussi des filtres Liquid intégrés, et la notation pointée appliquera le filtre plutôt que de récupérer le métachamp quand la clé est manquante.

Pour les cinq cas d'utilisation de page de produit ayant le plus d'impact (onglets de contenu personnalisé, badges de produit, tableaux de spécifications, PDF téléchargeables et listes de produits associés), chacun nécessite sa propre définition et un bloc Liquid correspondant dans le fichier sections/main-product.liquid de votre thème.

Ce qui a changé en 2026: les mises à jour qui comptent

Printemps '26 (annoncé à mi-2026):

• Les métachamps du panier se transfèrent aux commandes. Activez cartToOrderCopyable sur une définition de métachamp de commande et toute valeur de métachamp de panier du paiement est automatiquement copiée à la commande résultante. C'est un grand déblocage pour la logique post-achat dans Shopify Flow.
• Créer des métachamps sans quitter la page de la ressource. Vous n'avez plus besoin de naviguer vers Paramètres > Données personnalisées pour ajouter une nouvelle définition; vous pouvez le faire en ligne à partir de n'importe quel enregistrement de client, de commande ou de collection.
• Épinglez jusqu'à 50 métachamps sur les pages d'administration de produits, clients et commandes.
• Filtrage par syntaxe pointée ShopifyQL. Les métachamps sont maintenant supportés en tant que dimensions et filtres dans ShopifyQL avec la syntaxe pointée, disponible via l'API Analytics et l'éditeur en ligne. Cela signifie que vous pouvez segmenter vos rapports d'analyse par n'importe quel champ personnalisé que vous avez défini.
• Interface GraphQL simplifiée. L'édition Printemps '26 a expédié une interface de lecture/écriture simplifiée pour les métachamps et les métaobjects, réduisant le code réutilisable dans le code d'application.
• Les métachamps d'utilisateur boutique sont lisibles pendant le paiement via Shopify Functions, vous permettant de construire des personnalisations de paiement spécifiques à l'acheteur contre les données de client stockées.

API GraphQL Admin 2026-07 (version candidate à partir de juillet 2026):

• Métachamps sur les transferts d'inventaire. Vous pouvez maintenant définir et configurer les métachamps directement sur les transferts d'inventaire pour stocker les numéros de lot, les codes de fournisseur, les détails d'expédition, ou les identifiants de référence ERP sans appel metafieldsSet séparé.

Hiver '26:

• Les métachamps et métaobjects se rendent plus rapidement sur les vitrines, supportent un filtrage de requête plus riche, et permettent des limites d'entrée plus élevées que les versions d'API précédentes.

Octobre 2025 (API 2025-10):

• Ajout des types article_reference et list.article_reference, permettant aux commerçants de créer des liens produit-article formels pour les flux de commerce SEO piloté par le contenu et éditorial.

Métachamps vs métaobjects: quand utiliser lequel

Un métachamp stocke un seul élément de données personnalisées sur une ressource existante. Un métaobject est une entrée de contenu autonome et réutilisable avec son propre schéma multi-champs, et sa propre interface d'administration. Utilisez un métachamp quand les données appartiennent à et n'ont de sens que sur un produit spécifique (ou commande, ou client). Utilisez un métaobject quand le contenu est réutilisé sur plusieurs produits, comme un guide de tailles partagé, une histoire de marque, ou un profil de fournisseur.

Vous connectez les deux avec un métachamp metaobject_reference: le champ sur le produit pointe vers l'entrée métaobject, et la mise à jour de l'entrée met à jour chaque produit la référençant automatiquement.

Métachamps et la couche d'achat IA

C'est l'angle que la plupart des commerçants manquent en 2026. L'Édition Été '26 « Everywhere Edition » de Shopify a rendu le Protocole Commerce Universel (UCP) actif par défaut sur chaque boutique, permettant aux agents d'achat IA de lire votre catalogue. Les données structurées à l'intérieur de vos métachamps (spécifications, ingrédients, certifications, matériaux) sont exactement ce que les agents IA et les analyseurs de résultats enrichis de Google consomment pour décider de présenter votre produit.

Les métachamps de catégorie méritent une attention particulière ici. Ce sont des attributs de produit qui correspondent à une catégorie de produit spécifique et aident à rendre les produits plus découvrables sur votre site, sur les marchés, et sur les moteurs de recherche. Quand vous attribuez la bonne catégorie de produit dans Shopify, vous obtenez des entrées de métachamp de catégorie par défaut préremplies (par exemple, une catégorie Chemises vous donne des champs de taille, encolure, longueur de manche, tissu, sexe, et couleur). Remplissez-les de manière cohérente et vous alimentez des données structurées à chaque canal en aval simultanément.

Si vous avez décomposé les descriptions de produits en métachamps séparés pour la lisibilité, notez que vous ne pouvez actuellement pas cartographier plus d'un champ Shopify à un seul champ de description du Catalog Shopify. La solution est de créer un métachamp combiné qui concatène votre description et les données de métachamp clé, puis cartographier ce seul champ au catalogue.

Gouvernance: la partie que la plupart des équipes sautent

Les métachamps sont faciles à créer et très faciles à laisser s'étendre. Quelques règles qui préviennent un nettoyage coûteux plus tard:

• Documentez votre schéma. Maintenez une feuille de référence (une simple feuille de calcul fonctionne) qui enregistre chaque namespace, clé, type, ressource propriétaire, et quelle application ou équipe possède la définition.
• Utilisez les définitions standard chaque fois qu'une existe. Elles sont interopérables, auto-validées, et immunisées contre les collisions de noms.
• Ne changez jamais un type après avoir des données en direct. Migrer de date_time à money, par exemple, rend toutes les valeurs existantes invalides. Planifiez les types correctement dès le départ.
• Discipline du namespace. Utilisez des namespaces distincts par application ou équipe (logistics, marketing, compliance) afin que vous puissiez auditer et nettoyer par namespace sans affecter les champs non liés.
• Testez les écritures comme des opérations atomiques. La mutation metafieldsSet est atomique: soit toutes les 25 valeurs dans un appel unique réussissent, soit aucune. Structurez vos importations en masse autour de cette garantie.

Si vous avez besoin d'aide pour concevoir un schéma de métachamp pour un catalogue complexe ou intégrer des métachamps dans une vitrine personnalisée, consultez la page Services de développeur Shopify ou le travail de développeur de thème Shopify que je fais avec les commerçants.

Référence rapide: guide de syntaxe Liquid

Les métachamps font partie de ces fonctionnalités où consacrer deux heures à apprendre les principes fondamentaux vous épargne des semaines de contournements plus tard. Définissez votre schéma avec soin, utilisez les définitions standard partout où elles existent, et connectez vos champs à la fois à votre vitrine et à votre couche d'analyse. Les mises à jour 2026, en particulier la copie panier-à-commande et le filtrage ShopifyQL, signifient que vos données de métachamp sont plus exploitables que jamais.