Metafields Shopify : définitions, types et gestion

Les metafields sont des paires clé-valeur qui ajoutent tes propres données à une ressource Shopify. Les produits en sont les propriétaires les plus fréquents, mais les variantes, collections, clients, commandes et la boutique elle-même peuvent aussi porter des metafields. Chaque metafield se compose des quatre parties du tableau ci-dessous. Le namespace et la key forment ensemble son identifiant, donc custom.material sur un produit est un autre champ que specs.material.

Les marchands travaillent en général dans le namespace custom, que Shopify propose quand tu crées un champ dans l'admin. Les apps utilisent leurs propres namespaces, et Shopify réserve un namespace propre à l'app ($app dans l'API) pour les données qui appartiennent à une app. Le modèle complet est dans la présentation des metafields sur shopify.dev.

Une définition de metafield est le schéma : nom, namespace et key, type, description optionnelle et règles de validation. La valeur, ce sont les données enregistrées sur un produit. Shopify conseille lui-même de créer d'abord la définition, car c'est elle qui fait d'un metafield un champ sur la page produit de l'admin, impose la validation et te permet d'utiliser le champ dans les collections automatisées, les filtres de l'admin et, si ton thème prend en charge les sources dynamiques, dans l'éditeur de thème.

Une valeur peut exister sans définition. L'Admin API l'accepte tant que tu envoies le type, ce qu'elle exige quand il n'existe pas de définition pour ce namespace, cette key et ce type de propriétaire. Ces valeurs sont enregistrées, mais personne ne voit de champ de saisie typé pour elles dans l'admin. Si tu crées plus tard une définition avec le même namespace, la même key et le même type, tu peux y migrer les valeurs existantes, et les valeurs qui ne respectent pas les nouvelles règles de validation peuvent alors être corrigées.

Le type détermine ce qu'une valeur peut contenir et comment les thèmes et les apps la lisent. Shopify regroupe grosso modo les types comme dans le tableau. La plupart des types de base et tous les types de référence existent aussi en liste, comme list.single_line_text_field, sauf boolean, id, json, language, money, multi_line_text_field et rich_text_field. La liste complète et à jour est sur la page des types de données de metafields.

La taxonomie produit standard de Shopify donne à chaque produit une catégorie, distincte du type de produit en texte libre. La catégorie pilote les metafields de catégorie : des attributs propres à cette catégorie, comme la taille, l'encolure et la couleur pour les t-shirts. Leurs valeurs sont des entrées de métaobjets avec des valeurs standard qui renvoient aux valeurs standardisées de Shopify, et tu peux renommer une entrée (par exemple Noir en Graphite) ou lier un champ à une option de variante pour qu'un changement s'applique partout.

Tu fixes la catégorie sur la page produit, où la section des metafields de catégorie affiche alors les champs de cette catégorie, ou en masse via l'éditeur en masse ou un CSV avec l'ID ou le chemin de la catégorie. Quand tu changes de catégorie, les metafields qui ont une valeur ou un lien de variante sont repris, les vides non. Shopify le documente sur sa page sur la catégorie de produit.

Pour un seul produit, la page produit de l'admin suffit. Pour un catalogue, il te faut une des voies de modification en masse ci-dessous. Chacune a ses propres règles, alors vérifie-les avant de changer des centaines de produits. Plus de détails sur ces voies dans modifier tes produits Shopify en masse.

Les limites gênent rarement le premier jour, mais elles façonnent la conception des champs pour un catalogue qui grandit. Chaque app et chaque équipe qui crée ses propres définitions puise dans le même quota par type de ressource. Les chiffres ci-dessous viennent des limites des metafields de Shopify et de la référence MetafieldsSetInput ; revérifie-les avant un chantier plus large, car Shopify les ajuste.

Quand les données produit vivent dans un PIM, le PIM devient l'endroit où tu modifies les caractéristiques, et le connecteur Shopify les écrit dans les metafields. Il y a ainsi une seule source pour les valeurs que partagent ta boutique en ligne, tes flux et tes marketplaces. Le partage des rôles compte : le PIM écrit les valeurs, et les définitions qui rendent ces valeurs visibles dans Shopify se configurent dans Shopify.

Le connecteur PIM Shopify de WISEPIM écrit les valeurs de metafields avec metafieldsSet. Par défaut, il écrit wisepim.ean, wisepim.mpn et wisepim.country_of_origin, wisepim.cost en number_decimal et wisepim.short_description en multi_line_text_field. La marque va dans le champ natif de Shopify pour le fournisseur (Vendor), pas dans un metafield. Les FAQ produit, si tu les utilises, vont en json dans wisepim.faqs et wisepim.faq_schema.

Chaque attribut que tu actives pour Shopify dans la gestion des attributs est aussi écrit : sous le namespace wisepim avec une key dérivée du code de l'attribut, ou dans son namespace, sa key et son type d'origine si l'attribut vient d'une définition de metafield Shopify importée. Les mappings de champs par connecteur peuvent désactiver une entrée ou la remplir depuis un autre attribut, une valeur fixe ou un modèle, et une valeur qui ne correspond pas à son type est ignorée au lieu d'être envoyée.