Usar archivos CSV para importar y exportar productos
Puedes usar un archivo CSV (valores separados por comas) para importar productos a tu tienda Shopify y exportarlos desde tu tienda. Cuando usas un archivo CSV, puedes importar o exportar muchos productos y sus detalles al mismo tiempo. Esto puede ser útil si quieres intercambiar información de productos entre Shopify y otras plataformas.
Para obtener más información sobre cómo usar archivos CSV, consulta open and edit a CSV file.
En esta página
Descargar un archivo CSV de muestra
Puedes descargar y ver un sample product CSV file para usarlo como plantilla. Si usas el archivo de ejemplo, ten en cuenta lo siguiente:
- El archivo de muestra contiene dos productos de ejemplo e incluye algunas variantes. Es probable que tu archivo de importación tenga más productos y variantes. Si usas el archivo de muestra para crear tu propio archivo de importación, asegúrate de eliminar todos los productos de ejemplo.
- El archivo de ejemplo incluye la Inventory quantity columna, que se usa solo en tiendas que tienen una única sucursal. Si usas varias locations y quieres importar o exportar cantidades de inventario, usa el inventory CSV file.
- El archivo de ejemplo incluye las columnas Price / International y Compare-at price / International, pero están en blanco porque no hay precios diferentes para los productos de ejemplo cuando se venden a nivel internacional. Obtén más información sobre International CSV columns.
Consideraciones para el archivo CSV de productos
Antes de usar un archivo CSV de productos, revisa las siguientes consideraciones.
Dar formato al archivo CSV de productos
Para que el archivo CSV de productos funcione correctamente, verifica que cumpla con los siguientes criterios:
- La primera línea del archivo CSV de productos debe contener los encabezados de columna según se especifica en la product CSV description table.
- Cada columna debe estar separada por una coma.
Columnas obligatorias en el archivo CSV de productos
Estas columnas deben estar presentes en las siguientes condiciones:
- Cuando creas un archivo CSV de productos para importar productos nuevos, la única columna obligatoria es Title. Si agregas variantes para un producto, entonces URL handle también es obligatoria.
- Cuando actualizas productos con un archivo CSV, las únicas columnas obligatorias son URL handle y Title.
Dependencias de datos
Aunque las Title y URL handle columnas son las únicas columnas obligatorias cuando actualizas productos con un archivo CSV, los datos de algunas columnas dependen de los datos de otras.
Por ejemplo, si actualizas una columna relacionada con las variantes, como SKU o Weight value (grams), entonces los datos de esas columnas dependen de los datos de las variantes correspondientes. En este caso, también debes incluir las Option1 name y Option1 value columnas.
Columnas CSV internacionales
Si tienes Markets configurados en la tienda, la exportación del CSV refleja los mercados que creaste. De forma predeterminada, el CSV incluye las siguientes columnas:
Included / [Primary], donde[Primary]se reemplaza por el nombre del primary marketIncluded / InternationalPrice / InternationalCompare-at price / International
Si reemplazas tu mercado internacional por tu propio mercado, en el nombre del encabezado, International cambia al nombre del mercado.
Por ejemplo, si creas un mercado para cada continente y uno de tus mercados se llama South America, los encabezados de columna se ajustan de la siguiente manera en el archivo CSV de exportación:
Included / Internationalse convierte enIncluded / South AmericaPrice / Internationalpasa a serPrice / South AmericaCompare-at price / Internationalpasa a serCompare-at price / South America
Metacampos en columnas CSV
Los metacampos de producto son compatibles en la importación y exportación masiva de productos mediante archivos CSV. Después de definir un metacampo de producto, se incluye en las exportaciones CSV de productos. El formato del encabezado de columna es: <name> (product.metafields.<namespace>.<key>). También puedes usar product.metafields.<namespace>.<key>. Por ejemplo, el formato de un metacampo Fabric es el siguiente: Fabric (product.metafields.shopify.fabric) o, excluyendo el nombre y el paréntesis, product.metafields.shopify.fabric. Puedes encontrar el espacio de nombres y la clave de un metacampo en Configuración > Datos personalizados > Productos > Metacampo. Más información sobre product metafields.
Los valores de opción también son compatibles para la importación/exportación de CSV de productos. Usa las columnas Option LinkedTo para vincular una opción a un metacampo. Luego, puedes usar valores de metaobjeto en las columnas Option values correspondientes.
Metacampos de variante
Los metacampos de variante no son compatibles con la importación/exportación de productos en CSV. Para editar metacampos de variante de forma masiva, debes usar el editor masivo de variantes y luego agregar columnas de metacampos. Más información sobre editing variant details in bulk.
Descripción de las columnas del archivo CSV de productos
La siguiente tabla detalla todas las posibles columnas del CSV de productos.
Además de la Title columna, hay otras columnas que deben tener un valor. En la siguiente tabla se indican las columnas obligatorias. Para estas columnas, se crea un valor predeterminado si se dejan en blanco o si se omiten del archivo CSV.
Columnas del archivo CSV de productos
| Columna | Descripción, incluido el comportamiento predeterminado para celdas vacías |
|---|---|
| Title | El nombre del producto que quieres mostrar a los clientes. Por ejemplo, Women's Snowboard. |
| URL handle | El identificador único de cada producto. El identificador de URL se usa en la URL de la página de producto y se basa en el valor de la Title columna. Por ejemplo, si el valor de la Title columna es Black Sunglasses, entonces el valor en la URL handle columna es black-sunglasses de forma predeterminada. Puedes personalizar el valor del identificador de URL si quieres que la URL de la página de producto sea diferente del nombre del producto.Un identificador de URL válido puede contener letras, guiones y números, pero no puede contener espacios. |
| Description | La description of the product, que proporciona detalles sobre qué es el producto. |
| Vendor | El nombre del origen o la fuente de los productos que vendes. Si fabricas el producto tú, entonces el valor de la columna Vendor debe ser el mismo nombre de la tienda que usas cuando inicias sesión en Shopify.
Más información sobre managing vendor information. |
| Product category |
Una etiqueta que describe el tipo de producto y que se usa para calcular la tasa de impuestos en Estados Unidos. La etiqueta debe tomarse de la Shopify's Standard Product Taxonomy. Una categoría de producto estandarizada válida se puede identificar con:
|
| Type |
Una etiqueta que describe el producto si necesitas una categoría personalizada para mantener los productos organizados, además de la categoría estándar de Shopify. Por ejemplo, si la categoría del producto es Más información sobre cómo agregar un tipo de producto. |
| Tags |
Agrega palabras clave para ayudar a los clientes a encontrar tu producto online, o para agrupar y filtrar productos:
La mayoría de las apps de hojas de cálculo agregan automáticamente comillas alrededor de las etiquetas. Si usas un editor de texto sin formato, debes agregar las comillas de forma manual. Por ejemplo, Más información sobre los formatos de etiquetas. |
| Published on online store |
Indica si el producto debe publicarse en el canal de ventas de la tienda online. Los valores válidos son:
Más información sobre cómo publicar en una tienda online. |
| Status |
Indica si el producto está disponible para los clientes. Si esta columna está presente, necesita un valor. Si la columna no está presente, el estado del producto se carga automáticamente como
Más información sobre los estados del producto. |
| SKU |
El SKU de una variante, que se usa para hacer seguimiento del inventario. La columna SKU no puede estar en blanco si usas un servicio de preparación de pedidos personalizado. |
| Barcode |
El código de barras, el ISBN o el UPC de la variante. Más información sobre los códigos de inventario. |
| Option1 name |
Crea variantes para un producto que tiene más de una opción, como talla o color, ingresando el nombre de la opción. Cada combinación de valores del nombre de la opción de un producto puede ser una variante de ese producto, como Un producto puede tener hasta 3 opciones. Si un producto tiene solo una opción, este valor debe ser Más información sobre cómo crear variantes. |
| Option1 value |
Si un producto tiene más de una opción, como talla o color, ingresa su valor. Por ejemplo, un valor para una opción de color podría ser Si vinculas un metacampo de categoría con la Precaución: cambiar los datos de esta columna elimina los valores de los ID de variante existentes y crea nuevos ID de variante. Cualquier cambio en los valores del ID de variante puede afectar las dependencias de terceros basadas en los ID de variante. Más información sobre cómo crear variantes de producto. |
| Option1 LinkedTo | Si una opción de producto está conectada a un metacampo de categoría, este valor debe ser product.metafields.shopify.{taxonomy_attribute} |
| Price |
El precio del producto o de la variante. Incluye solo el valor monetario sin el símbolo de la moneda. Por ejemplo, Más información sobre los precios de los productos. |
| Price / International |
Un precio fijo para ese producto en el mercado con el mismo nombre y en la moneda de ese mercado. Más información sobre las columnas CSV para International. |
| Compare-at price |
El precio original de la variante si el precio se redujo y quieres mostrar el precio de comparación. Incluye solo el valor monetario sin el símbolo de la moneda. Por ejemplo, Más información sobre cómo configurar precios de comparación. |
| Compare-at price / International |
Establece un precio de comparación fijo para ese producto en el mercado con el mismo nombre y en la moneda de ese mercado. Para usar un precio de comparación fijo se requiere un precio fijo para el producto en ese mercado. Más información sobre las columnas CSV para International. |
| Cost per item |
Cuánto te cuesta fabricar o adquirir el producto o la variante. Incluye solo el valor monetario sin símbolo de moneda. Por ejemplo, Más información sobre cómo configurar el costo por artículo. |
| Charge tax |
Si el producto está sujeto a impuestos, configura los impuestos según la ubicación. Los valores válidos son:
|
| Inventory tracker |
Indica qué servicio quieres usar para hacer seguimiento del inventario de la variante. Los valores válidos incluyen:
Si se eliminan las opciones de seguimiento de inventario existentes, ya no se hará seguimiento del inventario. Servicios de logística externos: para las variantes almacenadas en un servicio de logística externo, el archivo CSV exportado muestra |
| Inventory quantity |
La cantidad de artículos disponibles en existencias del producto o la variante. Esto solo aplica a tiendas Shopify que tienen una única sucursal. El valor predeterminado es Más información sobre cómo administrar el inventario disponible. |
| Continue selling when out of stock |
Indica si quieres permitir que los clientes compren artículos agotados. Los valores válidos son:
Más información sobre vender productos agotados. |
| Weight value (grams) |
El peso del producto o de la variante, expresado en gramos. Debes especificar solo el valor numérico, sin la unidad de medida ni decimales. Por ejemplo, si tu variante pesa:
5,125 kilogramos, ingresa El valor predeterminado es Usa pesos exactos si utilizas tarifas de envío calculadas por el transportista o un servicio de logística externo. |
| Weight unit for display |
La unidad de medida en la que quieres que se muestre el peso del producto en tu tienda. Los valores válidos son:
|
| Requires shipping |
Indica si el producto es físico (en lugar de digital, por ejemplo) y, por lo tanto, debe enviarse. Los valores válidos son:
Más información sobre los detalles de envío. |
| Fulfillment service |
El servicio de logística que utilizas para un producto o variante. Los valores válidos son:
Si usas un servicio de logística personalizado, introduce el nombre del servicio en esta columna siguiendo estas indicaciones:
Por ejemplo, si "Joan's Fulfillment" es el nombre de tu servicio de preparación de pedidos, ingresa Debes configurar un servicio de preparación de pedidos personalizado en el panel de control de Shopify antes de poder agregar el nombre del servicio en esta columna. Servicios de logística externos: para las variantes almacenadas en un servicio de logística externo, el archivo CSV exportado muestra Cuando importas un archivo CSV, establecer esta columna en un identificador de servicio de logística específico (por ejemplo, |
| Included / [Primary] |
Si vendes internacionalmente, esta columna indica si el producto se incluye para la venta en el mercado principal. El valor predeterminado es El nombre del encabezado de esta columna varía según el país o la región que se determina como tu mercado principal en International. Si cambias el mercado principal predeterminado, los encabezados de las columnas se muestran con el nuevo nombre del mercado. Consulta la sección de consideraciones para obtener más información. |
| Included / International |
Si vendes internacionalmente, esta columna indica si el producto se puede vender en tus mercados internacionales. El valor predeterminado es El nombre del encabezado de esta columna varía según el International que configuraste en la tienda. El mercado predeterminado es |
| Product image URL |
Introduce la URL de la imagen del producto. Shopify descarga las imágenes durante la importación y las vuelve a subir en tu tienda. Asegúrate de que el nombre del archivo de imagen:
Esta columna no es específica de las variantes. Usa la columna de imagen de la variante para agregar imágenes de variantes. |
| Image position |
Ingresa el número que representa el orden en que quieres que la imagen se muestre en la página del producto. Las imágenes se muestran en orden ascendente, empezando por un valor de posición de imagen de |
| Image alt text |
El texto alternativo (alt) describe la imagen y el producto que representa. Si una imagen no se puede cargar en un navegador por algún motivo, se muestra el texto alternativo. También lo usa la tecnología de asistencia para describir una imagen a clientes con discapacidad visual que usan un lector de pantalla, por ejemplo. Incluir texto alternativo puede mejorar el SEO del sitio web. Mantén el texto alternativo breve y descriptivo:
|
| Variant image URL |
Ingresa la URL de las imágenes de la variante. Asegúrate de que las URL añadidas funcionen y apunten a imágenes. |
| Gift card |
Indica si el producto es una tarjeta de regalo. Los valores válidos son:
Esta columna también permite editar otros detalles de la tarjeta de regalo de forma masiva, como el |
| SEO title |
El nombre del producto que se muestra en los resultados de los motores de búsqueda. El título SEO que ingreses puede ser alfanumérico e incluir hasta 70 caracteres. Los títulos SEO válidos son:
Si dejas esta columna en blanco, el Title se usa como título de la página en el listado de motores de búsqueda del producto. Más información sobre editar títulos de SEO. |
| SEO description |
La descripción SEO también se encuentra en la página de detalles del producto en el encabezado Vista previa en motores de búsqueda, dentro de Descripción. La descripción SEO que ingreses puede ser alfanumérica e incluir hasta 320 caracteres. Si dejas esta columna en blanco, el Description se usa. |
| Google Shopping / Google Product Category |
Si actualmente usas una categoría de producto de Google, puedes usarla como tu categoría de producto de Shopify. Puedes usar la categoría de producto, la Google Product Category o ambas. Proporciona la categoría más específica posible para cada artículo. La Google Product Category (GPC) (google_product_category) utiliza la taxonomía de productos de Google. Puedes introducir la categoría de producto de Google de cualquiera de las siguientes maneras:
|
| Google Shopping (Unstructured metafield) |
Los encabezados de columna variarán según el metacampo de Google Shopping que represente el valor incluido y llevarán el prefijo
Las columnas de Google Shopping pueden ser usadas por una app para sincronizar productos con Google Merchant Center. Sin embargo, el canal de Google y YouTube no utiliza estos metacampos. Puedes ignorar los valores de las columnas de metacampos que incluyan “Google Shopping” en su nombre, a menos que una app te indique usarlos. |
| Metafields |
Estos metacampos de producto se crean en la tienda. La definición de metacampo de producto se muestra en el encabezado de la columna como
|
Sobrescribir detalles de producto usando un archivo CSV de importación
Cuando importas un archivo CSV, puedes seleccionar la opción Sobrescribir productos con identificadores coincidentes. Si seleccionas esta opción, cuando el identificador del archivo CSV importado coincida con un identificador existente en tu lista de productos, los valores del archivo CSV sobrescriben los valores de las columnas correspondientes en la lista de productos existente. Si no seleccionas la opción de sobrescritura, los productos que coincidan con un identificador existente se ignoran durante la importación del CSV.
- Si una columna no obligatoria en el archivo CSV de importación está en blanco, el valor correspondiente en la lista de productos se sobrescribe como en blanco.
- Por ejemplo, el valor de Vendor en la lista de productos existente es
John's Apparel, pero la Vendor columna está en blanco en el archivo CSV que importas, entoncesJohn's Apparelse sobrescribe con un valor en blanco.
- Por ejemplo, el valor de Vendor en la lista de productos existente es
- Si una columna no obligatoria no se incluye en el archivo CSV de importación, pero sí está en la lista de productos existente, entonces el valor de la lista de productos permanece igual.
- Por ejemplo, si la Variant image URL columna está en la lista de productos existente, pero esa columna no está en el archivo CSV de importación, entonces el valor en la lista de productos no cambia.
- Si se incluye en el archivo CSV de importación una columna no obligatoria que dependa de datos de otras columnas no incluidas en el archivo, se eliminarán los datos existentes.
- Por ejemplo, si la columna SKU está incluida en el archivo CSV de importación, pero no las columnas Option1 value y Option1 name, entonces se elimina la opción de variante del producto.
- No se pueden usar archivos CSV para eliminar productos de forma masiva. Si quieres eliminar productos de forma masiva, puedes usar las acciones masivas en la sección Productos del panel de control.
- No se pueden usar archivos CSV para actualizar de forma masiva la disponibilidad de productos en otros canales de ventas. Más información sobre configurar la disponibilidad de productos en otros canales de ventas.
Excepción de la columna Collection
Para organizar los productos en colecciones durante la carga del archivo CSV, puedes agregar una columna nueva en cualquier lugar del archivo CSV con el nombre de encabezado Collection.
Cuando exportas un archivo CSV, la Collection no se incluye.
| Columna | Descripción |
|---|---|
| Collection |
Ingresa el nombre de la colección a la que quieres agregar este producto.
Solo puedes agregar un producto a una colección. Este valor puede quedar en blanco. La longitud máxima es de 255 caracteres. Más información sobre cómo sobrescribir los productos existentes afecta los datos de esta columna. |
Crea tu archivo CSV de productos
Para cada producto, tienes que decidir si es un producto simple o con variantes:
- Producto simple: un producto simple no incluye variantes. Si subes un producto que no tiene variantes, ingresa todos los campos del producto en la primera fila junto con la URL de la primera imagen. En las filas siguientes, ingresa solo el identificador de URL y la URL de cada imagen adicional.
- Producto con variantes: si cargas un producto que tiene variantes, ingresa todos los campos del producto en la primera fila junto con la URL de la primera imagen. En las filas siguientes, ingresa el identificador de URL. Luego omite las Title, Description, Vendor, y Tags columnas. Completa el resto de la información de las variantes y cada URL de imagen.
Después de agregar todos los productos e imágenes, guarda el archivo CSV en formato UTF-8 con saltos de línea estilo LF. Si no conoces las codificaciones, revisa la documentación del programa de hoja de cálculo o del editor de texto.
Para ver un archivo CSV de ejemplo, descarga este archivo CSV de productos de muestra y después ábrelo en Google Sheets o en otro programa de hoja de cálculo.
Prepara las imágenes
Un archivo CSV solo puede contener texto, por lo tanto, asegúrate de que todas las imágenes de producto estén en un sitio web existente. Esas URL de imagen se usan únicamente durante el proceso de importación del archivo CSV. Puedes eliminar las URL cuando termine la importación.
En los archivos CSV solo se pueden usar URL de imágenes. Los modelos 3D y los videos no se admiten en el CSV, pero puedes subirlos a Contenido > Archivos. Más información sobre tipos de multimedia de producto.
Las URL de imágenes de fuentes externas deben ser de acceso público. Subir tus imágenes a Contenido > Files ayuda a garantizar que todas las imágenes de producto sean correctas.
Según dónde esté tu archivo de imagen, realiza una de las siguientes acciones:
- Si los archivos solo están en tu computadora, debes subirlos a tu tienda Shopify en Contenido > Files o a otro servicio de alojamiento de imágenes, como GoDaddy, OneDrive, Dropbox o BucketLynx, y luego obtener su URL.
- Si te pasas a Shopify desde otra plataforma, puedes copiar las URL actuales de las imágenes y usarlas en el archivo CSV.
- Si el archivo CSV de productos se generó al exportar los productos desde Shopify, no necesitas hacer nada porque las imágenes ya están en el sitio web.
Cuando tengas las URL de cada imagen de producto, puedes empezar a crear el archivo CSV.
Agregar varias imágenes del producto en un archivo CSV
Puedes agregar más imágenes de producto a tu archivo CSV subiendo más imágenes en tu panel de control de Shopify. Si estás creando tu tienda Shopify con un archivo CSV, el proceso es un poco diferente. Revisa las siguientes consideraciones:
- Debes poder editar un archivo CSV. Shopify recomienda usar Google Sheets para ver una versión con formato de los archivos CSV.
- Puedes agregar hasta 250 imágenes a un producto.
- Las imágenes de producto deben estar en una URL de acceso público. Es decir, deben usar el protocolo
https://y no tener protección con contraseña. Para hacerlo, puedes subir imágenes en la página Archivos del panel de control de Shopify. Las URL se generan automáticamente. Después de hacer clic en Subir archivos, puedes seleccionar hasta unos cientos de imágenes para subirlas de forma masiva.
Agrega varias imágenes del producto a tu archivo CSV
- Inserta filas nuevas. Debes usar solo una fila por imagen.
- Copia y pega el identificador de URL.
- Copia y pega las URL de las imágenes.
Insertar una fila nueva
- Abre el archivo CSV en el programa de hoja de cálculo, como Google Sheets.
- Ubica los productos a los que quieres agregar imágenes.
- En la siguiente fila, haz clic y arrastra los números de fila para seleccionar varias filas. Selecciona la misma cantidad de filas que la cantidad de imágenes adicionales que agregas.

- Con esas filas resaltadas, haz clic con el botón derecho en cualquier parte del área resaltada y selecciona Insertar X filas arriba.

Copia y pega el valor del identificador de URL
Copia y pega el valor del identificador de URL del producto requerido en la columna A para tus filas nuevas.

Copia y pega las URL de las imágenes
- En la página Archivos, sube las imágenes a Shopify.
- Haz clic en el Copiar enlace ícono para una URL de imagen a la vez.

- En el archivo CSV en tu aplicación de hoja de cálculo, desplázate hacia las últimas columnas del archivo CSV.
- En el Product image URL columna, pega la URL de la imagen en cada línea.

- Repite los pasos 2 a 4 para todas las imágenes de este producto
- Opcional: para mejorar el SEO, ingresa valores en todos los campos de Image alt text . Más información sobre texto alternativo de la imagen.
- Guarda el archivo CSV y impórtalo a Shopify.