Importar un CSV de Shopify sin romper el catálogo

El CSV de Shopify es a la vez la mejor y la peor forma de gestionar un catálogo. Mejor: es el formato nativo, oficial, que permite editar 10.000 productos de una sola vez. Peor: un CSV mal estructurado puede duplicar, sobrescribir o eliminar tu catálogo en 3 minutos sin pedir confirmación.

Aquí tienes la estructura exacta, las 6 columnas que no debes modificar nunca en bloque y el procedimiento de rollback para recuperar rápido si algo falla.

La estructura de un CSV nativo de Shopify

Exporta un producto desde tu admin de Shopify (Products → Export) para ver la estructura oficial. Las columnas clave:

Columna	Función	¿Modificable en bulk?
`Handle`	Identificador único (= slug de URL)	⚠️ Nunca
`Title`	Nombre del producto	✅ Sí
`Body (HTML)`	Descripción	✅ Sí
`Vendor`	Marca/proveedor	✅ Sí
`Type`	Tipo de producto	✅ Sí
`Tags`	Tags (separados por comas)	✅ Sí, con cuidado
`Published`	Publicado sí/no (`TRUE`/`FALSE`)	✅ Sí
`Option1 Name`, `Option1 Value`	Nombre + valor de la primera variante	⚠️ Nunca
`Option2 Name`, `Option2 Value`	Segunda variante	⚠️ Nunca
`Option3 Name`, `Option3 Value`	Tercera variante	⚠️ Nunca
`Variant SKU`	Código SKU de la variante	⚠️ Nunca
`Variant Price`	Precio de la variante	✅ Sí
`Variant Compare At Price`	Precio tachado (precio anterior)	✅ Sí
`Variant Inventory Qty`	Cantidad en stock	✅ Sí
`Image Src`	URL de imagen	✅ Sí
`Image Alt Text`	Texto alt de la imagen	✅ Sí
`SEO Title`	Title SEO	✅ Sí
`SEO Description`	Meta description	✅ Sí
`Status`	`active`/`archived`/`draft`	✅ Sí, con cuidado

Cada línea = un SKU, no un producto. Un producto con 3 variantes = 3 líneas que comparten el mismo Handle.

Las 6 columnas que no debes modificar nunca en bloque

Estas columnas son las claves de integridad de tu catálogo. Tocarlas a la ligera rompe el conjunto:

`Handle`

El handle genera la URL pública del producto. Cambiar un handle:

Cambia la URL del producto (/products/chaussure-derby → /products/chaussure-derby-v2)
Rompe todos los backlinks externos
Rompe los enlaces internos (emails transaccionales, menús, anuncios de Google Shopping)
Hace perder el ranking SEO acumulado

Regla: no modifiques nunca un Handle existente. Solo al crear productos nuevos.

`Variant SKU`

El SKU es la clave de identificación de las variantes en tu stock, tu WMS y tus herramientas analíticas. Cambiarlo:

Desajusta tu inventario si usas un sistema externo (ERP, WMS)
Rompe las integraciones (fulfillment providers, proveedores de dropshipping)
Puede crear variantes duplicadas si Shopify deja de reconocer la original

Regla: edita los SKU producto por producto, nunca en bulk CSV.

`Option1 Name`, `Option2 Name`, `Option3 Name`

Los nombres de opción definen la estructura de las variantes. Cambiarlos después de crear el producto:

Invalida las variantes existentes (el producto con Option1 Name = Talla pasa a Option1 Name = Size, lo que crea opciones nuevas)
Crea duplicados silenciosos
Puede disparar el número de variantes (de 20 a 200 en pocos segundos)

Regla: los nombres de opción se fijan al crear el producto, punto. Si necesitas cambiarlos, hazlo desde la interfaz de admin, producto por producto.

Preparar el CSV: las 5 comprobaciones antes de subirlo

Antes de cualquier importación, revisa esto:

Check 1 — Codificación UTF-8

Abre el CSV en un editor de texto (VS Code, Notepad++). Comprueba que los acentos y caracteres especiales se muestran correctamente. Si ves chaÃ®ne en lugar de chaîne, el CSV está en latin1 o windows-1252. Hay que reconvertirlo a UTF-8.

Excel guarda por defecto en latin1; evita Excel para editar un CSV destinado a Shopify. Usa LibreOffice Calc, Google Sheets o VS Code.

Check 2 — Separador coma

El CSV de Shopify usa la coma como separador. En configuraciones regionales francesas, Excel usa punto y coma por defecto. Si al abrirlo ves todos los datos en una sola columna, el separador es incorrecto.

Check 3 — Escape de comas dentro de los campos

Si una descripción contiene una coma (muy frecuente), el campo debe ir entre comillas:

Handle,Title,Body (HTML)
derby-cuir,"Chaussure Derby en cuir","Élégante, confortable, fabriquée en France"

Sin comillas, la coma de "Élégante, confortable" se interpretaría como un campo nuevo y desplazaría todo.

Check 4 — Líneas duplicadas

Un handle que aparece 2 veces en el CSV = Shopify tratará la segunda línea como una variante, no como un producto nuevo. Puede dar sorpresas.

En Google Sheets o Excel, usa Data → Remove duplicates para limpiar.

Check 5 — Caracteres especiales en las URLs de imágenes

Image Src debe ser una URL pública, accesible sin auth. Prueba 3-5 URLs aleatorias con curl -I https://cdn.example.com/image.jpg: respuesta 200 obligatoria. Si tienes URLs con espacios o caracteres especiales, URL-encódelas (%20 para espacio).

Gestionar variantes sin duplicar

Un producto con 3 variantes se describe en 3 líneas CSV:

Handle,Title,Option1 Name,Option1 Value,Variant SKU,Variant Price
derby-cuir,Derby Cuir,Talla,42,DERBY-BLK-42,149.00
derby-cuir,,,,,
derby-cuir,,,,,

Línea 1: producto completo con Title y Option1 Name
Líneas 2-3: SOLO el Handle y los valores de variante (Option1 Value, SKU, Price, etc.). No repitas Title, Body, Vendor, etc.; si no, Shopify los considera modificaciones y puede duplicar.

Es la sintaxis CSV nativa de Shopify. Sorprende al principio, pero es rigurosa.

Imágenes: Drive vs CDN vs Shopify Files

Tres opciones para las URLs de imágenes:

Opción 1 — Google Drive

❌ No funciona para Shopify. Drive devuelve una página HTML, no una imagen directa. Shopify falla en silencio.

Opción 2 — CDN público (Cloudflare Images, Amazon S3 + CloudFront, Bunny CDN)

✅ Recomendado para importaciones grandes. Las imágenes se alojan fuera de Shopify y luego Shopify las descarga en el momento de la importación.

Coste típico: 1-5 € al mes para 1.000 imágenes en un CDN.

Opción 3 — Shopify Files

✅ Subida manual de imágenes en Content → Files de Shopify y luego uso de las URLs de Shopify en el CSV. Adecuado para catálogos pequeños (<500 imágenes).

Límite: la subida a Shopify Files es manual, no se puede automatizar con scripts para 10.000 imágenes.

Recomendación: CDN público para la importación inicial; después Shopify aloja las imágenes automáticamente tras la importación.

Rollback antes de publicar

Shopify no ofrece rollback nativo para una importación CSV que ha salido mal. Pero puedes prepararlo antes:

Paso 1 — Exportación antes de importar

Justo antes de importar, exporta tu catálogo completo (Products → Export → CSV file for Excel, Numbers, or other spreadsheet programs). Guarda esa exportación con la fecha en el nombre (catalog-2026-04-23-antes-import.csv).

Paso 2 — Importar con publicación en modo draft

Modifica tu CSV para que Published = FALSE o Status = draft en todos los productos importados. Los productos se crean, pero quedan invisibles en la tienda.

Paso 3 — Verificación manual

En el admin, revisa 20 productos aleatorios importados. Comprueba:

Imágenes cargadas correctamente
Variantes correctas
Precio correcto
Descripción limpia

Paso 4 — Publicación por lotes

Si todo está correcto, publica. Si detectas un problema, solo tienes que eliminar los productos en draft, volver a importar el CSV de copia de seguridad y empezar de nuevo.

En caso de daños importantes

Si la importación ha sobrescrito tu catálogo activo sin pasar por draft:

Importa inmediatamente tu CSV de copia de seguridad: volverá a sobrescribir el estado actual
Las URLs y las reviews se conservan (Shopify las identifica por Handle)
Cuenta con 1-2 h para que Google vuelva a rastrear y recupere posiciones

Alternativas al CSV nativo: cuándo pasar a una herramienta especializada

El CSV nativo es potente, pero pesado. Para operaciones frecuentes sobre >1000 productos:

Matrixify (antes Excelify): la más completa, gestiona relaciones complejas, ~20 $/mes
Shopify Flow: automatización interna de Shopify, ideal para triggers (stock bajo, tag, etc.)
Ecomptimize: optimiza descripciones, metas y SEO en todo el catálogo; el archivo fuente sigue descargable durante 30 días para reimportar si hay problemas

Para reescribir descripciones en bloque con control de calidad, una herramienta dedicada supera claramente al CSV. Ver Ecomptimize para Shopify.

Importar un CSV de Shopify sin romper el catálogo