Catalog Precheck
Guías
H001

Shopify CSV “Encabezado CSV no válido: faltan encabezados”: qué verificar

Verifique la primera fila CSV para conocer los nombres exactos de las columnas de productos que su importación necesita. La falta de un encabezado Title es una causa común, pero las columnas requeridas dependen de si crea productos, los actualiza o agrega variantes.

Definición de la regla

Falta la columna Title obligatoria.

Crítica

Límites de la corrección automática: Esta regla requiere revisión manual; los datos comerciales no se modifican automáticamente.

Definición de la regla

Falta un URL handle donde lo requiere el contexto de actualización o variante.

CríticaAdvertencia

Límites de la corrección automática: Esta regla requiere revisión manual; los datos comerciales no se modifican automáticamente.

No pegue todas las columnas de una plantilla antigua
La página de error de Shopify muestra una fila de encabezado completa más antigua. La guía de formato CSV de su producto actual proporciona diferentes columnas mínimas por escenario de importación. Comience con su archivo real y la operación prevista.

A qué apunta el mensaje

La primera fila define las columnas. Un encabezado mal escrito, espacios en blanco adicionales, un delimitador incorrecto o un encabezado copiado de otro tipo de CSV pueden impedir que Shopify reconozca los campos. Verifique la fila del encabezado real antes de cambiar los datos del producto.

¿Qué encabezados se requieren?

Crea un producto simple:

Title es la única columna requerida. Se puede generar un identificador de URL ausente a partir del título.

Actualizar un producto existente:

Incluya Title y el identificador de URL para que Shopify pueda identificar el producto.

Agregar variantes:

Incluir identificador de URL. Al actualizar columnas relacionadas con variantes, como SKU, conserve también las columnas coincidentes de nombre Option1 y valor Option1; omitir datos de opciones dependientes puede cambiar las variantes.

Falta un encabezado Title

Este ejemplo de actualización mínima tiene nombres de productos, pero su primer encabezado no es la columna Title de Shopify.

No válido: el título Product no es Title
Product title,URL handle
Tee,tee

Catalog Precheck informa H001 para el encabezado Title faltante y advierte que el título de Product es desconocido.

Corregido: use el encabezado admitido
Title,URL handle
Tee,tee

Cambie el nombre de la columna solo si sus valores realmente son títulos de productos. Guarde una copia del archivo original.

Cómo arreglar el encabezado de forma segura

  1. 01

    Confirme que este es un producto Shopify CSV, no un inventario ni la exportación de otra aplicación. Abra una copia como texto UTF-8 separado por comas.

  2. 02

    Inspeccione la primera fila, incluida la ortografía y los espacios finales. Haga coincidir cada encabezado con los datos debajo de él; no cambie el nombre de valores no relacionados sólo para silenciar un error.

  3. 03

    Elija crear o actualizar antes de decidir qué columnas son necesarias. Para actualizaciones y variantes, conserve el identificador y las columnas de opciones dependientes.

  4. 04

    Guarde un nuevo CSV, verifíquelo localmente, luego revise la muestra actual de Shopify y la configuración de importación antes de importar.

Verifique el encabezado localmente

Elija el modo de importación deseado en Catalog Precheck. H001 señala que falta un Title; H002 comprueba cuándo se requiere el identificador de URL; H003 advierte sobre rumbos no reconocidos. Estas son comprobaciones de archivos, no una importación Shopify simulada. Al regresar se abre un nuevo validador; el archivo seleccionado anteriormente no se conserva.
Revisa mi CSVVer reglas de encabezado
Lo que el corrector no puede decidir
No puede saber si un encabezado desconocido pertenece a una integración de aplicación válida, si una columna cuyo nombre ha cambiado contiene los datos comerciales correctos o lo que ya existe en su tienda. Un informe limpio no garantiza el éxito de la importación.

Fuentes consultadas: 28 de septiembre de 2026. Shopify: problemas comunes de importación · Shopify: formato CSV del producto actual

Catalog Precheck es una herramienta independiente y no está afiliada a Shopify.