Aller au contenu principal

Format CSV des métachamps Shopify : namespace, key et types

Aucun téléversementTesté jusqu’à 200 MB

Comprenez les en-têtes de métachamps, les règles namespace/key, les types CSV pris en charge, les listes et limites de valeurs.

Publié le: 2026-09-23Mis à jour: 2026-09-231 minVérifier le format des métachamps Shopify
Illustration du flux de données pour « Format CSV des métachamps Shopify : namespace, key et types »

Les métachamps produit Shopify ne forment pas une liste fixe de colonnes. Chaque définition devient un en-tête dynamique identifié par namespace et key.

Format de l’en-tête

La forme canonique est product.metafields.<namespace>.<key>. Un export peut ajouter un nom lisible, mais l’en-tête canonique suffit pour un import préparé.

Namespace et key acceptent lettres, chiffres, tirets et tirets bas. Le namespace comporte 2–255 caractères et la key 2–64. Nablyx reçoit namespace.key et génère l’en-tête complet.

Le type doit correspondre à la définition

Le CSV produit prend en charge booléen, couleur, dates, dimensions, argent, nombres, références produit, texte, URL, volume, poids et plusieurs listes. Le type n’est pas écrit dans l’en-tête ; la définition Shopify reste la référence.

Listes séparées par des points-virgules

Les listes compatibles utilisent des éléments séparés par un point-virgule. La plupart sont limitées à 128 éléments ; les listes de références de métaobjets ont une limite documentée plus élevée.

Valider uniquement ce que le CSV permet de prouver

Sans connexion à la boutique, les règles personnalisées d’une définition sont inconnues. Le contrôle local valide le schéma public et Shopify reste responsable des choix, regex ou autres contraintes spécifiques.

Vérifier le format des métachamps Shopify

Voir la transformation

Les en-têtes maladroits deviennent des colonnes prêtes à importer.

Renommez les colonnes nécessaires tout en gardant chaque valeur sous le bon en-tête.

cust_idcustomer_id
given_namefirst_name
mailemail

✓ Les valeurs restent dans la bonne colonne