La importación CSV de productos de Shopify es potente pero implacable. Una cabecera de columna mal formada, un espacio adicional o una fila de variante incorrecta puede hacer que toda tu importación falle — o que se omitan cientos de productos en silencio.

Esta guía cubre cada columna del formato CSV de productos de Shopify, con ejemplos, errores comunes y consejos para generar archivos válidos a partir de exportaciones de WooCommerce.

La referencia de columnas del CSV de Shopify

El CSV de productos de Shopify utiliza 33 columnas estándar. Esto es lo que hace cada una:

Campos principales del producto

Columna	Tipo	Notas
`Handle`	Obligatorio	Identificador amigable para URL. Debe ser único por producto. Usa solo letras minúsculas, números y guiones. Ejemplo: `zapatillas-azules-running`
`Title`	Obligatorio (primera fila)	Título del producto. Solo necesario en la primera fila para productos con múltiples variantes. Las filas siguientes del mismo producto (mismo Handle) lo dejan en blanco.
`Body (HTML)`	Opcional	Descripción del producto en formato HTML. Shopify acepta HTML pero elimina las etiquetas no seguras. Solo en la primera fila por producto.
`Vendor`	Opcional	Nombre de la marca o fabricante. Aparece en el administrador de Shopify y puede usarse para filtrar. Solo en la primera fila.
`Product Category`	Opcional	Taxonomía de productos estandarizada de Shopify (no es lo mismo que las colecciones). Ejemplo: `Ropa y accesorios > Zapatos`
`Type`	Opcional	Tipo de producto personalizado (texto libre). Diferente de la Categoría de Producto. A menudo se usa para mapear las categorías de WooCommerce.
`Tags`	Opcional	Lista de etiquetas separadas por comas. Ejemplo: `running, deportes, exterior`. Solo en la primera fila.
`Published`	Opcional	`TRUE` o `FALSE`. Determina si el producto es visible en tu tienda.

Campos de opción (para productos variables)

Shopify admite hasta 3 tipos de opciones por producto. Los nombres de opción van en Option1 Name, Option2 Name, Option3 Name, y los valores para cada variante van en Option1 Value, Option2 Value, Option3 Value.

Columna	Ejemplo
`Option1 Name`	`Color`
`Option1 Value`	`Azul`
`Option2 Name`	`Talla`
`Option2 Value`	`M`
`Option3 Name`	`Material`
`Option3 Value`	`Algodón`

Importante: Shopify impone un límite estricto de 3 tipos de opciones y 100 variantes por producto. WooCommerce no tiene esos límites — si tus productos WC superan esto, necesitarás reestructurarlos antes de importar.

Campos de variante

Columna	Tipo	Notas
`Variant SKU`	Recomendado	Unidad de mantenimiento de inventario. Debe ser único en todas las variantes de tu tienda. Déjalo en blanco si no usas SKUs.
`Variant Grams`	Opcional	Peso en gramos (siempre en gramos, independientemente de la unidad de peso de tu tienda). Ejemplo: `500` para 500g.
`Variant Inventory Tracker`	Opcional	`shopify` para rastrear inventario, en blanco para no rastrear.
`Variant Inventory Qty`	Opcional	Cantidad inicial de inventario. Solo aplica si Inventory Tracker es `shopify`.
`Variant Inventory Policy`	Opcional	`deny` para evitar ventas en exceso, `continue` para permitirlas.
`Variant Fulfillment Service`	Opcional	Normalmente `manual`. Puede ser un ID de servicio de gestión de pedidos de terceros.
`Variant Price`	Obligatorio	Precio de venta. Número decimal, sin símbolo de moneda. Ejemplo: `29.99`
`Variant Compare At Price`	Opcional	Precio original (mostrado tachado). Se usa para indicar una oferta. Debe ser mayor que Variant Price para mostrar como descuento.
`Variant Requires Shipping`	Opcional	`TRUE` o `FALSE`. El valor predeterminado es TRUE.
`Variant Taxable`	Opcional	`TRUE` o `FALSE`. El valor predeterminado es TRUE.
`Variant Barcode`	Opcional	Valor de código de barras EAN, UPC o ISBN.

Campos de imagen

Columna	Notas
`Image Src`	URL completa de la imagen del producto. Shopify descargará y alojará esta imagen. Debe ser accesible públicamente en el momento de la importación.
`Image Position`	Entero (1, 2, 3...). Controla el orden de visualización de las imágenes. Posición 1 = imagen principal del producto.
`Image Alt Text`	Atributo alt de la imagen. Importante para SEO y accesibilidad.
`Variant Image`	URL de la imagen a asociar con esta variante específica. Debe coincidir con un valor de Image Src en las filas del mismo producto.

Campos SEO

Columna	Notas
`SEO Title`	Etiqueta de título de la página. Por defecto usa el título del producto si está en blanco. Mantén menos de 70 caracteres.
`SEO Description`	Meta descripción. Mantén menos de 160 caracteres para la mejor visualización en resultados de búsqueda.

Otros campos

Columna	Notas
`Google Shopping / Google Product Category`	Categoría de taxonomía de Google para el feed de productos. Opcional pero útil para campañas de Google Shopping.
`Google Shopping / Gender`	Male, Female o Unisex. Para ropa.
`Google Shopping / Age Group`	Adult, Kids. Para ropa.
`Google Shopping / MPN`	Número de pieza del fabricante.
`Google Shopping / AdWords Grouping`	Para grupos de productos de Google Ads.
`Google Shopping / AdWords Labels`	Etiquetas separadas por comas para Google Ads.
`Google Shopping / Condition`	New, Refurbished o Used.
`Google Shopping / Custom Product`	TRUE o FALSE.
`Google Shopping / Custom Label 0–4`	Cinco campos de etiqueta personalizada adicionales para feeds de Google Shopping.
`Variant Weight Unit`	La unidad para mostrar: `kg`, `g`, `lb` o `oz`. Nota: Variant Grams siempre está en gramos independientemente de esta configuración.
`Variant Tax Code`	Código fiscal para Avalara u otros servicios fiscales. Déjalo en blanco para la mayoría de tiendas.
`Cost per item`	Tu coste de adquisición del artículo. No visible para los clientes. Usado para informes de beneficios.
`Included / [Ubicación]`	TRUE o FALSE. Si esta variante está en stock en una ubicación específica (para inventario en múltiples ubicaciones).
`Status`	`active`, `draft` o `archived`.

Estructura de filas para productos con múltiples variantes

Aquí es donde la mayoría de las importaciones CSV fallan. Para un producto con múltiples variantes, necesitas una fila por variante, todas compartiendo el mismo Handle. Solo la primera fila tiene los campos del nivel de producto (Title, Body HTML, Vendor, Tags).

Ejemplo — una camiseta con 3 opciones de color:

Handle,Title,Body (HTML),Vendor,Type,Tags,Option1 Name,Option1 Value,Variant Price,Image Src,Image Position
camiseta-basica,Camiseta Básica,"<p>Camiseta de algodón clásica.</p>",ACME,Camisetas,camiseta,Color,Azul,24.99,https://ejemplo.com/camiseta-azul.jpg,1
camiseta-basica,,,,,,Color,Roja,24.99,https://ejemplo.com/camiseta-roja.jpg,2
camiseta-basica,,,,,,Color,Negra,24.99,https://ejemplo.com/camiseta-negra.jpg,3

Reglas clave:

El mismo Handle en todas las filas del mismo producto
Title, Body HTML, Vendor, Tags solo en la primera fila (dejar en blanco en las filas siguientes)
Cada fila necesita un Variant Price
Image Src e Image Position pueden aparecer en cualquier fila — usa Position para controlar el orden

Ejemplo de producto simple

Para un producto sin variantes:

Handle,Title,Body (HTML),Vendor,Type,Tags,Option1 Name,Option1 Value,Variant SKU,Variant Price,Image Src,Image Position,Status
taza-azul,Taza de Café Azul,"<p>Taza de cerámica de 350ml.</p>",HomeCosas,Tazas,cocina,Title,Default Title,TAZA-AZL-001,14.99,https://ejemplo.com/taza.jpg,1,active

Para productos simples, usa Option1 Name = Title y Option1 Value = Default Title.

Errores de importación comunes

"Producto no válido" u omisión silenciosa de fila

Campos obligatorios faltantes (Handle, Variant Price). Verifica que cada fila tenga un Handle y que cada variante tenga un precio.

Imágenes que no se cargan tras la importación

Las URLs de imagen deben ser URLs HTTPS accesibles públicamente. Shopify las obtiene en el momento de la importación — si la URL redirige, requiere autenticación o devuelve un 404, la imagen se omite en silencio.

Variantes faltantes tras la importación

Si el Handle coincide con un producto existente en tu tienda, Shopify actualizará ese producto en lugar de crear uno nuevo. Las variantes existentes que no estén en el CSV serán eliminadas.

Precio mostrado como $0.00

Variant Price debe ser un número decimal sin símbolo de moneda, comas ni espacios. 29.99 es correcto; $29.99, 29,99 o 29 .99 fallarán.

Productos importados como borradores en lugar de activos

Comprueba la columna Status — si es draft o está en blanco, los productos no serán visibles para los clientes. Ponla en active.

Formato de peso: la trampa de los gramos

El formato CSV de Shopify almacena el peso en la columna Variant Grams — siempre en gramos, independientemente de la unidad de peso configurada en tu tienda. La columna Variant Weight Unit solo controla la unidad de visualización en la interfaz de administración.

Si estás migrando desde WooCommerce y tus productos tienen pesos en kg o libras, debes convertirlos a gramos para el CSV. Por ejemplo: 2,5 kg → 2500 gramos, 5 lbs → 2268 gramos.

k-sync gestiona esta conversión automáticamente — el panel Convertidor de Peso te permite convertir todos los pesos de variantes entre unidades antes de exportar, y la exportación CSV siempre genera Variant Grams en la unidad correcta.

Generar un CSV válido de Shopify automáticamente

Construir manualmente un CSV correcto de Shopify para cientos o miles de productos es propenso a errores y consume mucho tiempo. k-sync genera CSVs compatibles con Shopify automáticamente a partir de los datos de WooCommerce importados:

Cabeceras de columna correctas en el formato adecuado
Filas de productos con múltiples variantes estructuradas correctamente (primera fila con datos del producto, filas siguientes con datos de variante)
Peso convertido a gramos
Precio formateado correctamente (sin símbolos de moneda)
Descripciones HTML preservadas
Las 33 columnas completas donde existen datos

Puedes exportar todos los productos o solo los seleccionados, validar los datos primero para detectar problemas y volver a descargar después de corregir los errores.

Genera tu CSV de Shopify gratis con k-sync →

Formato CSV de productos de Shopify: la guía de referencia completa (2026)