Corregir errores al importar metacampos de productos Shopify

Los errores de importación de metacampos suelen venir de una definición equivocada, un valor incompatible con su tipo o una fila de producto sin las columnas necesarias.

Error de Shopify: Validation failed: Value must be a valid product reference

Shopify muestra este mensaje cuando un metacampo de referencia de producto apunta a un producto que todavía no existe en la tienda. Importa o crea primero los productos referenciados y vuelve a importar después los valores de los metacampos. Shopify incluye el mensaje exacto en su guía de problemas habituales de importación CSV.

Corrige namespace y key

Cada cabecera debe convertirse en product.metafields.<namespace>.<key>. Usa solo letras, números, guiones y guiones bajos y respeta los límites de longitud.

Corrige los valores según su tipo

Booleanos, fechas, números, URL y medidas deben cumplir el formato del tipo seleccionado. Las listas se separan con punto y coma y deben respetar su número máximo de elementos.

Si Shopify marca una regla adicional, revisa la definición en la tienda: opciones, regex y límites personalizados no están codificados en el CSV.

Revisa columnas de producto y destinos duplicados

Para actualizaciones conserva Title y URL handle (o Handle compatible). Evita mapear dos columnas de origen al mismo encabezado de salida.

Repite la comprobación tras corregir

El preflight recorre todo el archivo y mantiene los totales exactos. Descarga un CSV nuevo solo cuando ya no queden errores bloqueantes.

Corregir CSV 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