Guía
Cómo subir productos masivamente a Shopify
Shopify puede crear o actualizar muchos productos a la vez desde un archivo CSV. Así funciona la importación, dónde se complica y qué hacer cuando los datos de tus productos están en PDF de proveedores.
La importación de productos mediante CSV de Shopify es la forma habitual de añadir un catálogo de forma masiva. Preparas una hoja de cálculo en el formato de Shopify, la subes en el administrador y Shopify crea los productos, las variantes y las imágenes.
Como en cualquier importación, el éxito depende de los datos que introduzcas. Esta guía cubre el proceso con CSV, las alternativas y la preparación que te evita tener que corregir cientos de productos después.
Opción 1: importar un CSV de productos en el administrador de Shopify
En el administrador de Shopify, ve a Productos y elige Importar. Sube un CSV en el formato de productos de Shopify, decide si deben sobrescribirse los productos con el mismo handle, previsualiza y confirma. Shopify procesa el archivo en segundo plano y te avisa cuando termina.
- Parte de la plantilla CSV de productos de ejemplo de Shopify, o exporta un producto existente para ver las columnas exactas.
- La columna URL handle (Handle en las plantillas antiguas) identifica un producto; las filas que comparten un handle son variantes o imágenes adicionales del mismo producto.
- Las columnas habituales incluyen Title, Description (Body (HTML)), Vendor, Product category, Type, Tags, Status, Option1 name / Option1 value, SKU (Variant SKU), Price, Barcodes (Variant Barcode) y Product image URL (Image Src).
- Las imágenes se descargan desde URL públicas en el momento de la importación.
- Guarda el archivo como CSV en UTF-8 para conservar los caracteres especiales.
Cómo gestionar correctamente las variantes
Las variantes hacen tropezar a la mayoría en la primera importación. Cada producto puede tener hasta tres opciones (por ejemplo, talla, color, material). La primera fila de un producto contiene los campos del producto y los nombres de las opciones; cada fila siguiente con el mismo handle añade una variante con sus valores de opción, SKU, precio e inventario.
Mantén idénticos los nombres de las opciones en todas las filas y haz que la combinación de valores de opción de cada variante sea única, de modo que cada fila corresponda exactamente a una variante. Una fila que tiene columnas de variante pero no Option1 name ni Option1 value hace que Shopify cree una variante predeterminada y elimine las existentes.
Opción 2: apps de importación masiva
Las apps de importación de la Shopify App Store amplían el CSV nativo: compatibilidad con Excel y Google Sheets, metacampos, importaciones programadas desde feeds de proveedores y migración desde otras plataformas. Merece la pena considerarlas cuando importas con frecuencia o necesitas campos que el CSV estándar no cubre.
Opción 3: la Admin API de Shopify
Las apps y las integraciones personalizadas pueden crear productos mediante la Admin API de Shopify en lugar de un archivo CSV. Así se evitan por completo los vaivenes con hojas de cálculo, y es como muchas herramientas de catálogo y de listados crean productos en Shopify.
Doc2Shelf sigue esta vía: conectas tu tienda con OAuth y los listados revisados se crean como productos en borrador, con imágenes, precios y categorías.
Preparar los datos de producto para Shopify
Antes de cualquier subida masiva, comprueba que:
- Cada producto tiene un handle único y cada variante un SKU único.
- Los títulos siguen un mismo patrón (por ejemplo, marca + producto + atributo clave).
- Las descripciones son texto propio, no texto del proveedor pegado, y usan HTML sencillo.
- Las especificaciones usan unidades y nombres coherentes para poder convertirse en opciones, etiquetas o metacampos.
- Los productos se importan primero sin publicar para poder revisar una muestra antes de salir en vivo.
Cuando los datos de producto proceden de PDF de proveedores
Una importación CSV da por hecho que ya tienes datos limpios y estructurados. Cuando los proveedores envían hojas de especificaciones y catálogos en PDF, alguien tiene que extraer primero títulos, especificaciones e identificadores y redactar las descripciones, normalmente la parte más lenta de todo el trabajo.
Doc2Shelf sustituye ese paso: lee los PDF de proveedores, extrae los datos de producto con información de confianza para su revisión, redacta los textos del listado de Shopify y crea los productos revisados en tu tienda conectada como borradores, sin CSV.
Columnas del CSV de productos de Shopify: nombres actuales y equivalentes antiguos
Shopify ha cambiado el nombre de varias columnas del CSV de productos. Su referencia actual del CSV usa etiquetas como URL handle, Description, SKU y Barcodes, mientras que muchas plantillas y tutoriales siguen mostrando Handle, Body (HTML), Variant SKU e Image Src. Shopify indica que mantiene la compatibilidad con los nombres de columna antiguos, por lo que un archivo antiguo se sigue importando, pero una exportación nueva usa las etiquetas actuales, y un archivo que mezcla ambos estilos es difícil de comprobar.
La tabla recoge las columnas que necesitan la mayoría de las cargas masivas. El cambio de Barcode a Barcodes consta en la documentación de Shopify; las demás etiquetas antiguas se han emparejado según lo que contiene cada campo, así que confírmalas con una exportación de tu propia tienda. Los encabezados distinguen entre mayúsculas y minúsculas.
| Columna actual | Qué contiene | Ejemplo | Etiqueta antigua o notas |
|---|---|---|---|
| Title | Nombre del producto | Hervidor de acero inoxidable 1,7 L | Obligatoria para crear un producto. |
| URL handle | Identificador único del producto usado en la URL del producto | steel-kettle | Las plantillas antiguas la llaman Handle. Las filas que comparten un handle pertenecen a un mismo producto. |
| Description | Descripción del producto | Hervidor inalámbrico con… | Las plantillas antiguas la llaman Body (HTML). |
| Vendor | Marca o fabricante | Acme | — |
| Product category | Categoría de la Standard Product Taxonomy | hg-15-1-2 | La ruta completa o el ID de categoría, no ambos. |
| Type | Tu propio tipo de producto | Hervidor eléctrico | De formato libre, a diferencia de la categoría. |
| Tags | Etiquetas separadas por comas | inalámbrico, cocina | Hasta 250 etiquetas por producto. |
| Status | Estado del producto | draft | Importa como borrador, revisa y luego activa. |
| SKU | SKU de la variante | KTL-SLV | Las plantillas antiguas la llaman Variant SKU. |
| Barcodes | Códigos de barras de la variante | gtin:4006381333931 | Antes Barcode (y antes aún Variant Barcode). Separa varios con punto y coma; el prefijo de tipo es opcional. |
| Option1 name / Option1 value | La primera opción y el valor de esta variante | Color / Plata | Option2 y Option3 siguen el mismo patrón. |
| Option1 LinkedTo | Vínculo de la opción con un metacampo de categoría | product.metafields.shopify.[attribute] | Opcional; consulta la sección sobre la taxonomía más abajo. |
| Price / Compare-at price | Precio de venta y precio de comparación | 49.90 / 59.90 | Las columnas Price / [Market] contienen precios específicos de cada mercado. |
| Inventory quantity | Existencias disponibles | 25 | Funciona junto con la columna Inventory tracker. |
| Weight value (grams) | Peso de la variante en gramos | 1200 | Las plantillas antiguas la llaman Variant Grams. Weight unit for display fija la unidad que ven los compradores. |
| Product image URL | URL pública de una imagen del producto | https://cdn.example.com/kettle.jpg | Las plantillas antiguas la llaman Image Src. |
| Image position / Image alt text | Orden de la galería y texto alternativo | 1 / Hervidor de acero, vista frontal | Texto alternativo de hasta 512 caracteres. |
| Variant image URL | Imagen que se muestra al seleccionar esta variante | https://cdn.example.com/kettle-black.jpg | — |
| SEO title / SEO description | Título y metadescripción para los resultados de búsqueda | — | Hasta 70 y 320 caracteres. |
| Metafield columns | Valores de los metacampos del producto | Material (product.metafields.custom.material) | Formato del encabezado: Nombre (product.metafields.namespace.key). |
Variantes y opciones: límites y trampas
Un producto de Shopify puede tener hasta tres opciones (por ejemplo, talla, color y material) y hasta 2048 variantes. El límite de variantes era de 100 hasta que Shopify lo amplió en octubre de 2025, así que las plantillas y guías anteriores todavía citan la cifra antigua. Algunos temas, apps y canales de venta se diseñaron en torno al límite antiguo, por lo que conviene comprobar los tuyos antes de importar un producto con cientos de variantes.
La primera fila de un producto contiene los campos del producto y los nombres de las opciones. Cada fila siguiente con el mismo URL handle añade una variante con su valor de opción, SKU, precio, peso e inventario, y deja vacíos los campos del producto.
Dos comportamientos pillan desprevenidos a quienes importan actualizaciones. Si una fila incluye columnas de variante como SKU o peso pero omite Option1 name y Option1 value, Shopify crea una variante predeterminada y elimina las variantes existentes. Y cambiar un valor de opción (por ejemplo, renombrar “Grey” como “Gray”) elimina los ID de variante y crea otros nuevos, lo que puede romper las apps y los feeds que hacen referencia a esos ID.
| Fila | URL handle | Title | Option1 name | Option1 value | SKU |
|---|---|---|---|---|---|
| Primera fila | steel-kettle | Hervidor de acero | Color | Plata | KTL-SLV |
| Fila siguiente | steel-kettle | (vacío) | (vacío) | Negro | KTL-BLK |
Imágenes de producto en un CSV de Shopify
Shopify descarga las imágenes de la columna Product image URL durante la importación, así que cada URL debe ser de acceso público y apuntar directamente al archivo de imagen. Los enlaces que requieren iniciar sesión, abren una página de vista previa o caducan antes de que se ejecute la importación son los motivos habituales por los que faltan imágenes.
Un producto puede tener hasta 250 imágenes u otros archivos multimedia. Pon la primera imagen en la primera fila del producto; añade cada imagen adicional en su propia fila con el mismo URL handle, la URL de la imagen, su Image position y su Image alt text. Para mostrar una imagen concreta cuando un comprador elige una variante, pon su URL en Variant image URL en la fila de esa variante.
El texto alternativo puede tener hasta 512 caracteres, y Shopify recomienda 125 o menos. Describe lo que muestra la imagen (“Hervidor de acero inoxidable, vista frontal con indicador de nivel de agua”) en lugar de repetir el título del producto.
Categoría de producto, metacampos y la Standard Product Taxonomy
La columna Product category asigna una categoría de la Standard Product Taxonomy de Shopify, elegida según la función principal del producto. Introduce la ruta completa, como Home & Garden > Linens & Bedding > Bedding > Bed Sheets, o el ID de categoría, como hg-15-1-2, pero no ambos. Un producto sin categoría se trata como sin categorizar.
Al asignar una categoría se desbloquean sus metacampos de categoría, que la taxonomía llama atributos de producto. La categoría Shirts de Shopify (camisas), por ejemplo, tiene nueve, entre ellos talla, escote, tejido y color, y los valores de color pueden mostrarse como muestras. La columna Option1 LinkedTo conecta una opción de variante con uno de estos metacampos de categoría.
La categoría importa más allá de la navegación: Shopify Tax la utiliza para fijar los tipos impositivos. Type, en cambio, es una etiqueta de formato libre que defines tú mismo, útil para tus propios filtros e informes.
Los metacampos personalizados de producto se importan mediante columnas con el encabezado Nombre (product.metafields.namespace.key), por ejemplo Material principal (product.metafields.custom.material). Los metacampos de variante no se admiten en el CSV de productos, así que configúralos en el administrador, con una app o a través de la API.
Límites del CSV de Shopify y longitudes de los campos SEO
Estos son los límites que Shopify documenta para las importaciones de CSV de productos y los registros de productos. Las cifras de guías antiguas, en especial el límite de 100 variantes, están desfasadas.
Las columnas SEO title y SEO description rellenan el título y la metadescripción que se usan en los resultados de búsqueda. Escríbelos producto por producto en lugar de copiar un mismo patrón en todo el catálogo: empieza con el nombre del producto y el atributo que buscan los compradores, como la talla, el material o el número de modelo.
| Elemento | Límite | Qué hacer |
|---|---|---|
| Tamaño del archivo CSV | 15 MB | Divide los catálogos grandes; mantén todas las filas de un producto en un mismo archivo. |
| Opciones por producto | 3 | Modela las demás diferencias como productos independientes o como metacampos. |
| Variantes por producto | 2048 | Comprueba que tu tema y tus apps soportan un gran número de variantes. |
| Imágenes y archivos multimedia por producto | 250 | Limita la galería a las imágenes que ayuden a decidir a los compradores. |
| Etiquetas por producto | 250 | Usa las etiquetas para filtrar y automatizar. |
| Códigos de barras por producto o variante | 20 | Añade un prefijo de tipo como gtin: cuando conozcas el tipo. |
| SEO title | 70 caracteres | Empieza con el nombre del producto y el atributo clave. |
| SEO description | 320 caracteres | Resume el producto poniendo primero los datos clave. |
| Texto alternativo de la imagen | 512 caracteres (se recomiendan 125 o menos) | Describe lo que muestra la imagen. |
Sobrescribir o crear: cómo se comportan las actualizaciones
Para crear un producto, el CSV solo necesita un Title; para añadir variantes también hace falta el URL handle. Para actualizar un producto existente, Shopify necesita el URL handle y el Title, y al iniciar la importación eliges sobrescribir los productos con handles coincidentes.
Trata una sobrescritura como determinante para todas las columnas que incluyas. El patrón más seguro es exportar, editar y volver a importar: exporta los productos que quieras cambiar, edita solo las celdas que lo necesiten, deja las columnas de opciones en su sitio e importa el archivo editado con la sobrescritura activada. Un archivo escaso creado desde cero hace que sea fácil provocar el comportamiento de eliminación de variantes descrito arriba.
Lee la vista previa de la importación antes de confirmar y prueba una actualización grande con unos pocos productos primero. La exportación que hiciste antes de editar es tu vía de retorno si algo sale mal.
Checklist previo a la importación y resolución de problemas
Repasa estos pasos antes de una importación grande; la tabla posterior recoge los problemas que surgen con más frecuencia.
- Exporta un producto de tu tienda y reutiliza su fila de encabezados, para que los nombres de las columnas coincidan exactamente.
- Asigna a cada producto un URL handle único y a cada variante un SKU único.
- Comprueba que los nombres y los valores de las opciones se escriban siempre igual y confirma que cada fila de variante tenga su valor de opción.
- Rellena Product category con una ruta o un ID copiado de la taxonomía.
- Abre una muestra de URL de imágenes en una ventana de navegación privada para confirmar que se cargan sin iniciar sesión.
- Establece Status en draft para la primera ejecución.
- Guarda como CSV en UTF-8 y confirma que el archivo pesa menos de 15 MB.
- Importa entre cinco y diez productos, revísalos en el administrador y en la tienda online, y luego importa el resto.
| Problema | Causa probable | Solución |
|---|---|---|
| Archivo rechazado | Supera los 15 MB o no está guardado como CSV en UTF-8 | Divide el archivo por productos y vuelve a guardarlo como CSV en UTF-8 |
| Columna ignorada | Encabezado con errores ortográficos o con otra combinación de mayúsculas y minúsculas | Copia los encabezados de una exportación reciente |
| Variantes desaparecidas tras una actualización | Columnas de variante enviadas sin Option1 name y value | Vuelve a importar incluyendo las columnas de opciones |
| Las apps perdieron el rastro de las variantes | Se cambió el nombre de un valor de opción, lo que creó nuevos ID de variante | Cambia el nombre de los valores de opción de forma deliberada y vuelve a conectar las apps afectadas |
| Productos divididos o fusionados por error | El URL handle difiere entre las filas de un mismo producto | Usa un único handle idéntico por producto |
| Faltan imágenes | URL no pública, no es un enlace directo al archivo o ha caducado | Aloja las imágenes en URL públicas estables |
| Categoría sin asignar | Ruta mal escrita, o se han indicado la ruta y el ID a la vez | Usa solo uno de los dos, copiado de la taxonomía |
| Código de barras no aceptado | La longitud no se corresponde con el tipo indicado | GTIN: 8, 12, 13 o 14 dígitos; UPC: 8 o 12; EAN: 8 o 13 |
| Faltan valores de metacampos | Formato de encabezado incorrecto, o es un metacampo de variante | Usa Nombre (product.metafields.namespace.key); configura los metacampos de variante en otro lugar |
Preguntas frecuentes
- ¿Cómo subo productos a Shopify de forma masiva y gratuita?
- Usa la importación CSV integrada en Productos → Importar. Se incluye en todos los planes de Shopify y gestiona productos, variantes e imágenes a partir de un archivo CSV en el formato de Shopify.
- ¿Puedo subir productos a Shopify desde Excel?
- El importador nativo necesita un CSV, así que guarda tu hoja de Excel como CSV en UTF-8 con los nombres de columna de Shopify. Algunas apps de importación pueden leer archivos de Excel directamente.
- ¿Una importación CSV sobrescribirá mis productos existentes?
- Los productos existentes solo se actualizan cuando eliges la opción de sobrescribir los productos con el mismo handle. Revisa la vista previa de la importación antes de confirmar y prueba primero con un archivo pequeño.
- ¿Por qué no se importan mis imágenes?
- Las URL de las imágenes deben ser enlaces directos y de acceso público a archivos de imagen. Los enlaces que requieren iniciar sesión, redirigen a una página web o proceden de un recurso compartido temporal suelen fallar.
- ¿Qué columnas son obligatorias en un CSV de productos de Shopify?
- Para crear un producto solo es obligatorio Title, además de URL handle cuando añades variantes. Para actualizar productos existentes, incluye URL handle y Title. Todo lo demás es opcional, aunque un listado utilizable normalmente necesita precio, SKU, categoría, descripción e imágenes.
- ¿Cuántas variantes puede tener un producto de Shopify?
- Hasta 2048 variantes con un máximo de tres opciones. Shopify subió el límite desde 100 en octubre de 2025, por lo que las plantillas y guías antiguas que indican 100 están desactualizadas.
- ¿Puedo importar metacampos con un CSV de Shopify?
- Los metacampos de producto, sí: añade una columna con el encabezado Name (product.metafields.namespace.key). Los metacampos de variante no se admiten en el CSV de productos y hay que configurarlos en el panel de administración, con una aplicación o mediante la API.
- ¿Cuál es el tamaño máximo de un CSV de productos de Shopify?
- Un CSV de productos no puede superar los 15 MB. Divide los catálogos más grandes en varios archivos y mantén todas las filas de un mismo producto en el mismo archivo.