Formato CSV de metacampos Shopify: namespace, key y tipos

Los metacampos de productos Shopify no forman una lista fija de columnas. Cada definición crea una cabecera dinámica identificada por namespace y key.

Formato de la cabecera

La forma canónica es product.metafields.<namespace>.<key>. Una exportación puede añadir un nombre legible, pero para preparar una importación basta con la cabecera canónica.

Namespace y key admiten letras, números, guiones y guiones bajos. Namespace tiene 2–255 caracteres y key 2–64. Nablyx recibe namespace.key y genera la cabecera completa.

El tipo debe coincidir con la definición

El CSV de productos admite booleanos, color, fechas, dimensiones, dinero, números, referencias de producto, texto, URL, volumen, peso y varias listas. El tipo no aparece en la cabecera; la definición de Shopify es la fuente de verdad.

Listas separadas por punto y coma

Los tipos de lista compatibles usan valores separados por punto y coma. La mayoría admite hasta 128 elementos; las listas de referencias a metaobjetos tienen un límite documentado mayor.

Valida solo lo que el CSV puede demostrar

Sin conectar con una tienda no se conocen reglas personalizadas de cada definición. El preflight valida el esquema público y Shopify sigue validando opciones, regex u otras restricciones propias.

Comprobar formato de metacampos Shopify

Mira la transformación

Los encabezados incómodos se convierten en columnas listas para importar.

Cambia el nombre de las columnas que necesites y mantén cada valor bajo el encabezado correcto.

cust_idcustomer_id

given_namefirst_name

mailemail

✓ Los valores siguen en la columna correcta