Catalog Precheck
Guías
V001

Shopify CSV “Error de validación: las opciones no son únicas”: cómo solucionarlo

Busque dos filas de variantes con la misma combinación de valores Option1–3 debajo de un identificador de producto. No cambies cada identificador repetido: las variantes de un producto normalmente lo comparten.

Definición de la regla

Variantes bajo un mismo Handle repiten la misma combinación de opciones.

Crítica

Límites de la corrección automática: Esta regla requiere revisión manual; los datos comerciales no se modifican automáticamente.

No inventar un nuevo valor de opción
Si este CSV actualiza un producto existente, cambiar el valor de una Opción puede crear nuevas ID de variante y afectar las aplicaciones que dependen de ellas. Confirme la variante deseada en su tienda antes de editarla.

Qué significa el error

Shopify dice que el archivo puede contener opciones duplicadas para un producto, o que el mismo producto puede aparecer en otro lugar bajo el mismo identificador. Compare la combinación completa de opciones, no solo una celda de Tamaño o Color. Se esperan manijas repetidas en filas de variantes genuinas.

Dos filas, un valor de tamaño

Ambas filas a continuación pertenecen a la T del mango y se resuelven en la combinación de opciones Tamaño: M. En una pantalla estrecha, desplace el bloque de código hacia los lados para ver todas las columnas.

No válido: combinación de opciones duplicadas
Title,URL handle,Option1 name,Option1 value
Tee,tee,Size,M
,tee,,M

La regla V001 marca ambas filas comerciales. Un nombre Title y Option1 en blanco en una fila de continuación no convierte a M en una variante diferente.

Corrección ilustrativa: dos tamaños distintos
Title,URL handle,Option1 name,Option1 value
Tee,tee,Size,M
,tee,,L

Utilice L solo si la segunda fila realmente describe la talla L. De lo contrario, elimine una fila realmente duplicada o corrija la asignación del producto después de verificar los datos de origen.

Cómo investigar de forma segura

  1. 01

    Conserva el CSV original. Agrupe las filas por identificador de URL y luego compare cada valor de Option1, Option2 y Option3 que no esté vacío dentro de cada producto.

  2. 02

    Compruebe si las filas repetidas son variantes distintas, filas de productos duplicadas accidentalmente o filas de continuación de solo imágenes. Un identificador repetido por sí solo no es motivo para cambiar el nombre de un producto.

  3. 03

    Corrija el error de fuente real: dé a una variante real su valor de opción verdadero, elimine solo un duplicado confirmado o use el identificador correcto si pertenece a otro producto.

  4. 04

    Ejecute la verificación local nuevamente, revise otros hallazgos y verifique cualquier cambio en las variantes existentes en Shopify antes de importar.

Encuentra combinaciones duplicadas localmente

La regla de verificación previa del catálogo V001 informa combinaciones Option1–3 repetidas y no vacías bajo el mismo identificador. Ignora las filas de solo imágenes. No puede decidir qué fila es correcta ni ver las variantes que ya están en su tienda. Al regresar se abre un nuevo validador; el archivo seleccionado anteriormente no se conserva.
Revisa mi CSVVer regla V001
Lo que sigue siendo incierto
Un análisis limpio a nivel de archivo no prueba que el CSV coincida con las variantes existentes del Shopify o que la importación se realice correctamente. Revise el producto deseado y los ID de variante antes de cambiar las opciones de un producto existente.

Fuentes consultadas: 28 de septiembre de 2026. Shopify: problemas comunes de importación · Shopify: opciones del producto CSV e ID de variante

Catalog Precheck es una herramienta independiente y no está afiliada a Shopify.