Error “Encabezado de CSV no válido: faltan encabezados” al importar a Shopify: causas y solución

Qué significa el mensaje

Cuando Shopify no puede relacionar la primera fila de tu archivo con su plantilla, el administrador muestra un aviso como “Encabezado de CSV no válido: faltan encabezados”, a veces seguido del nombre de una columna, por ejemplo Title. Según la documentación de Shopify:

• La primera línea del archivo debe contener los encabezados de columna de la plantilla, y conviene revisar que no haya espacios de más al final de esa línea.
• Los nombres de los encabezados distinguen mayúsculas y minúsculas: Shopify da el ejemplo de usar Handle y no handle.
• Si los encabezados son incorrectos, Shopify puede mostrar la ventana “Elegir encabezados de columna”, donde eliges el encabezado correcto de cada columna en un menú desplegable para continuar.

Por qué aparece tanto con hojas en español

Aunque tu administrador de Shopify esté en español, los nombres de las columnas del CSV siguen siendo los de la plantilla, en inglés (la propia página de ayuda en español muestra los encabezados en inglés). Una hoja que viene de un proveedor, de un marketplace, de tu sistema de inventario o de una plantilla propia suele tener columnas como Nombre, Precio o Existencias, y Shopify no las reconoce como suyas.

También puede ocurrir con un archivo que sí empezó en la plantilla: un espacio al final de un encabezado, una letra en minúscula, una columna extra o un programa de hojas de cálculo que cambió el formato del archivo. Un caso real en la Comunidad Shopify (en portugués) muestra a alguien que usó el archivo de ejemplo, pegó sus datos y guardó en UTF-8, y aun así recibió el error; la respuesta del personal de Shopify fue revisar que cada título coincida exactamente con el modelo y que no haya espacios sobrantes.

Cómo corregirlo, paso a paso

1. Descarga el archivo de ejemplo de Shopify desde la documentación de importación de productos (enlace al final) y ponlo junto a tu archivo.
2. Copia tus datos debajo de los encabezados de la plantilla, sin editar esos encabezados. Es la forma más sencilla de descartar errores de escritura.
3. Revisa mayúsculas y espacios. Variant Price (con un espacio al final) parece correcto en la hoja, pero no coincide.
4. Comprueba que la primera línea sean los encabezados. Un título, una línea en blanco o una nota encima de los encabezados hace que Shopify lea la fila equivocada.
5. Elimina las columnas que Shopify no conoce. Según su documentación, la columna Collection es la única adicional que puedes agregar sin romper el formato.
6. No mezcles estilos de nombres para el mismo campo. La documentación actual usa nombres como URL handle y Price; las plantillas anteriores usan Handle y Variant Price. Shopify mantiene compatibilidad con los antiguos, pero un archivo debe usar un solo estilo por campo.
7. Guarda el archivo en UTF-8 y con comas (mira la guía sobre cómo guardar un CSV desde Excel).
8. Prueba con uno o dos productos antes de importar todo el catálogo. Es una recomendación nuestra, pero evita sorpresas.

Tabla de equivalencias: de tu hoja en español a las columnas de Shopify

Esta tabla muestra nombres frecuentes en hojas en español y la columna de Shopify (plantilla clásica) a la que corresponden. Renombra los encabezados de tu hoja a los de la columna central. Son equivalencias sugeridas: confirma siempre con el archivo de ejemplo de Shopify.

Qué hace ShopiClean con los encabezados (y qué no)

Transparencia: ShopiClean es nuestro propio producto. Todo lo que aparece en esta guía se puede hacer a mano en una hoja de cálculo; la herramienta solo automatiza las revisiones. El análisis gratuito y la vista previa en pantalla de hasta 5 filas reparadas no tienen costo, y descargar el archivo reparado requiere el Pase de 7 días ($9 USD, pago único).

Las pruebas de ShopiClean que se mencionan aquí se hicieron el 21 de octubre de 2026 con archivos de ejemplo.

Qué hace:

• El CSV Validator & Fixer corrige mayúsculas y espacios en los nombres que reconoce como columnas de Shopify. En la prueba, handle pasó a Handle, Title a Title y Variant Price a Variant Price.
• Acepta tanto los nombres actuales (por ejemplo URL handle y Price) como los clásicos.
• Lista las columnas que no reconoce y avisa de que Shopify podría ignorarlas o rechazarlas, y avisa cuando no encuentra una columna de precio, porque Shopify importaría las variantes a 0.00.

Qué no hace:

• No traduce encabezados en español o portugués. El Supplier Converter tampoco los reconoce: al probarlo con columnas como Nombre y Precio se detuvo y pidió renombrar la columna del nombre a Title. Renombra los encabezados a mano con la tabla de arriba y luego usa el CSV Validator & Fixer.
• No puede ver tu tienda ni la ventana de importación de Shopify, así que el archivo de ejemplo de Shopify sigue siendo la referencia.

Fuentes y cómo se revisó esta guía

Los comportamientos de Shopify descritos aquí se revisaron en las páginas del Centro de ayuda de Shopify que aparecen abajo entre el 19 y el 21 de octubre de 2026. Shopify puede cambiar su sistema de importación; si algo difiere de lo que ves, confía en la documentación de Shopify.

• Centro de ayuda de Shopify: Soluciones a problemas comunes al importar archivos CSV de productos
• Centro de ayuda de Shopify: Using CSV files to import and export products (en inglés)
• Centro de ayuda de Shopify: Importing products with a CSV file (en inglés)

Guías relacionadas

• Cómo guardar un CSV de Excel en español para Shopify (UTF-8, punto y coma, comillas)
• Precios con coma decimal y punto de miles en un CSV de Shopify
• Todas las guías de solución de problemas