Les boutiques WooCommerce étendent couramment les données produits avec des champs personnalisés — via Advanced Custom Fields (ACF), les attributs de produits WooCommerce, WooCommerce Product Add-Ons, ou des méta-champs personnalisés directs. L'équivalent Shopify est les metafields : des données structurées clé-valeur attachées aux produits, variantes, clients, commandes, collections, et autres objets. Comprendre les metafields est essentiel pour une migration réussie car les attributs de produits qui résident dans les champs personnalisés WooCommerce doivent aller quelque part dans Shopify.

Que sont les metafields

Un metafield est une donnée structurée attachée à une ressource Shopify (produit, variante, collection, client, etc.). Il comporte trois composantes :

Espace de noms (Namespace) : Regroupe les metafields liés (ex. custom, product, seo). Utilisez un espace de noms descriptif pour votre projet (ex. clothing, electronics, specs).
Clé (Key) : Le nom du champ dans l'espace de noms (ex. material, warranty_years, compatible_models).
Valeur (Value) : Les données stockées, typées selon le type de metafield.

Exemple : product.metafields.clothing.material = "100% coton biologique"

Types de metafields

Type	Utilisation	Exemple
Texte sur une ligne	Valeurs texte courtes	Matériau, couleur, marque
Texte multi-ligne	Texte plus long, notes formatées	Instructions d'entretien, spécifications techniques
Entier	Nombres entiers	Années de garantie, âge minimum, quantité
Décimal	Nombres décimaux	Poids, dimensions, % d'alcool
Vrai/faux	Indicateurs booléens	Passe au lave-vaisselle, vegan, certifié bio
Date	Valeurs de date	Date de production, date d'expiration
URL	Liens	URL fiche de données de sécurité, certificat de laboratoire
JSON	Données structurées	Listes de compatibilité, tableaux de spécifications
Fichier	Fichiers joints	Manuel d'instructions PDF
Mesure	Valeur + unité	Poids en kg, hauteur en cm
Liste de [type]	Plusieurs valeurs du même type	Liste de modèles compatibles
Référence à un métaobjet	Lien vers un objet structuré personnalisé	Lié à un métaobjet "Artiste"

Définitions de metafields vs espaces de noms personnalisés

Shopify prend en charge deux approches pour les metafields :

Metafields définis : Configurés dans Shopify Admin → Paramètres → Données personnalisées. Ils ont un type spécifique, sont validés, apparaissent dans l'interface d'édition de produit, et peuvent être affichés dans les thèmes via des blocs metafield. Recommandés pour tous les champs que votre équipe veut modifier.
Metafields non structurés : Définis via l'API sans définition préalable. Utiles pour l'import de données programmatique mais non modifiables dans l'admin sans définition.

Lors de la migration avec k-sync, les metafields sont poussés vers Shopify via API. Créez des définitions de metafields dans Shopify Admin après la migration pour que votre équipe puisse les modifier sans accès API.

Remplacement des champs personnalisés WooCommerce

Approche WooCommerce	Équivalent metafield Shopify
Champ ACF sur le type de publication produit	Metafield défini (espace de noms produit)
Attribut de produit WooCommerce (global)	Options de produit Shopify (pour les variantes) ou metafields (pour les données de spécifications)
Champ personnalisé WooCommerce (meta box)	Metafield défini
Contenu d'onglet produit (WooCommerce Tab Manager)	Metafield (texte multi-ligne) + section de thème
Documents produits/pièces jointes PDF	Metafield de type : fichier

Affichage des metafields dans votre thème

Les thèmes Online Store 2.0 de Shopify (Dawn et tous les thèmes modernes) prennent en charge les blocs metafield dans l'éditeur de thème. Pour afficher un metafield sur une page produit :

Créez une définition de metafield dans Admin → Paramètres → Données personnalisées → Produits
Dans l'éditeur de thème en ligne, naviguez vers un template de page produit
Ajoutez un bloc "Texte" ou "Metafield" à la section produit
Configurez le bloc pour afficher le metafield spécifique

Pour les affichages de metafields complexes (tableaux, visibilité conditionnelle), une personnalisation Liquid du thème ou une application d'affichage de metafields (Metafields Guru, Custom Fields) est nécessaire.

Édition en masse des metafields après la migration

Après une migration k-sync, certains metafields seront renseignés par l'import (données existant dans WooCommerce), et d'autres nécessiteront une complétion manuelle. Pour l'édition en masse :

Shopify Admin → Produits → Tous les produits → Exporter : Les exports incluent les colonnes metafield pour les metafields définis. Modifiez dans un tableur, ré-importez.
Application Metafields Guru : Éditeur en masse style tableur pour les metafields dans l'admin Shopify.
API Shopify Admin : Mise à jour de metafields en masse via la mutation GraphQL metafieldsSet.

Stratégie de metafields pour la migration

Une approche pratique des metafields lors de la migration :

Auditez les champs personnalisés WooCommerce : Listez tous les champs personnalisés en utilisation dans vos types de produits. Notez quels champs sont affichés publiquement et lesquels sont uniquement internes.
Catégorisez chaque champ : Est-ce une option de variante (crée des SKUs achetables séparés) ? Une spécification (affichage uniquement) ? Un champ de suivi interne ? Un champ de contenu (texte long) ?
Concevez les espaces de noms : Utilisez un espace de noms par catégorie de produit (ex. electronics, clothing) ou un espace de noms pour toutes les données personnalisées (custom).
Créez les définitions avant l'import : Pré-créez les définitions de metafields dans Shopify pour que les valeurs importées par API soient immédiatement typées et modifiables.
Configurez l'affichage dans le thème : Configurez les blocs metafield du template de page produit pour les champs que les clients doivent voir.

Liste de vérification post-migration pour les metafields

Champs personnalisés WooCommerce audités et mappés vers des définitions de metafields Shopify
Définitions de metafields créées dans Shopify Admin → Paramètres → Données personnalisées
Blocs metafield du thème configurés pour les données de spécifications visibles publiquement
Outil d'édition en masse identifié pour l'enrichissement des metafields post-migration
Metafields internes uniquement définis avec l'espace de noms correct (non exposé dans le thème)
Contrôle ponctuel sur 20 produits : vérifiez que les valeurs de metafields ont correctement migré

Les metafields Shopify : guide pratique pour les boutiques migrant depuis WooCommerce (2026)