Atributos de producto de WooCommerce en CSV: guía completa

Cómo funcionan los atributos de WooCommerce en el CSV

Los atributos de producto de WooCommerce definen las dimensiones en las que varía un producto, normalmente talla, color o material. En una importación CSV, los atributos se representan como grupos de columnas numerados. Cada grupo de cuatro columnas corresponde a un atributo.

El patrón de nombres de las columnas es:

• Attribute 1 name
• Attribute 1 value(s)
• Attribute 1 visible
• Attribute 1 global

Para un segundo atributo, repite el patrón con Attribute 2 name, Attribute 2 value(s), etc.

Si WordPress está en español, la exportación usa nombres de columna en español; el importador acepta tanto esos nombres como los ingleses. Esta guía usa los nombres en inglés.

Referencia de columnas

| Columna | Formato | Descripción | |---|---|---| | Attribute N name | Texto | El nombre del atributo (por ejemplo, Color, Size) | | Attribute N value(s) | Texto, separado por barras verticales | El valor o valores de esta fila (por ejemplo, Blue o Blue | Red) | | Attribute N visible | 1 o 0 | 1 = se muestra en la página del producto; 0 = oculto | | Attribute N global | 1 o 0 | 1 = atributo global de taxonomía; 0 = atributo local |

Productos simples con varios valores de atributo

Para un producto simple disponible en varios colores (pero no como variaciones separadas), enumera todos los valores en la columna Attribute 1 value(s) separados por una barra vertical |:

Name,Type,SKU,Regular price,Attribute 1 name,Attribute 1 value(s),Attribute 1 visible,Attribute 1 global
Blue Scarf,simple,SCARF-001,14.99,Color,Blue | Navy | Teal,1,1

Así se crea un producto con un atributo Color que muestra los tres valores de color en la página del producto.

Productos variables con variaciones

En los productos variables, los atributos funcionan de otra manera. La fila principal enumera todos los valores posibles del atributo. Cada fila de variación indica solo el valor concreto de esa variación.

Fila principal (Type: variable):

Name,Type,SKU,Regular price,Attribute 1 name,Attribute 1 value(s),Attribute 1 visible,Attribute 1 global
T-Shirt,variable,TSHIRT,20.00,Size,S | M | L | XL,1,1

Filas de variación (Type: variation):

Name,Type,SKU,Regular price,Attribute 1 name,Attribute 1 value(s),Attribute 1 visible,Attribute 1 global
,variation,TSHIRT-S,18.00,Size,S,1,1
,variation,TSHIRT-M,18.00,Size,M,1,1
,variation,TSHIRT-L,20.00,Size,L,1,1
,variation,TSHIRT-XL,20.00,Size,XL,1,1

La columna Name queda vacía en las filas de variación: WooCommerce genera el nombre de la variación a partir de los valores de los atributos.

Dos atributos (talla + color)

Para un producto con dos dimensiones de atributo:

Fila principal:

Name,Type,SKU,Attribute 1 name,Attribute 1 value(s),Attribute 1 visible,Attribute 1 global,Attribute 2 name,Attribute 2 value(s),Attribute 2 visible,Attribute 2 global
Running Shoe,variable,SHOE,Size,7 | 8 | 9 | 10,1,1,Color,Black | White,1,1

Filas de variación:

,variation,SHOE-7-BLK,Size,7,1,1,Color,Black,1,1
,variation,SHOE-7-WHT,Size,7,1,1,Color,White,1,1
,variation,SHOE-8-BLK,Size,8,1,1,Color,Black,1,1

Cada fila de variación indica exactamente un valor por atributo (no una lista separada por barras verticales).

Atributos globales y locales

Atributos globales (Attribute N global: 1)

Los atributos globales se definen en la taxonomía de atributos de WooCommerce (Productos → Atributos en el panel de WordPress). Usa atributos globales cuando:

• Varios productos comparten los mismos términos de atributo (los mismos colores, las mismas tallas)
• Quieres filtrar productos por atributo en las páginas de la tienda
• Usas el widget de navegación por capas de WooCommerce

Al importar con global: 1, WooCommerce crea el término del atributo si todavía no existe. Los nombres de los atributos deben coincidir exactamente (se distinguen mayúsculas y minúsculas) para que WooCommerce los asocie con la taxonomía existente.

Atributos locales (Attribute N global: 0)

Los atributos locales son propios de un solo producto. Úsalos para especificaciones de un producto concreto que no se aplican a otros (por ejemplo, Material: 100% cashmere en un producto determinado).

Los atributos locales no se pueden usar para filtrar variaciones ni en la navegación por capas.

Errores comunes al importar atributos

No se reconocen las columnas de atributos

Causa: los nombres de las columnas no siguen exactamente el patrón: espacios incorrectos, numeración incorrecta o nombres abreviados.

Incorrecto: Attribute1 name, attribute 1 name, Attr 1 name Correcto: Attribute 1 name

Solución: usa los nombres de columna exactos, con un espacio entre Attribute y el número.

Los atributos de la variación no coinciden con los del principal

Causa: el nombre del atributo en una fila de variación no coincide con el de la fila principal, o la variación indica un valor que no estaba en la lista de valores del principal.

Solución: los nombres de los atributos deben ser idénticos en la fila principal y en las de variación. Los valores de las variaciones deben formar parte de los valores enumerados en la fila principal.

Separador de barra vertical con espacios

Causa: mezclar | (con espacios alrededor de la barra) y | (sin espacios). WooCommerce recorta los valores, pero las incoherencias pueden provocar discrepancias.

Solución: usa |, con o sin espacios alrededor, de forma coherente en todo el archivo. WooCommerce elimina los espacios alrededor de cada valor.

Corrígelo automáticamente con StriveFormats

Sube tu CSV de WooCommerce a StriveFormats. El validador revisa los nombres de las columnas de atributos, la coherencia de atributos entre principal y variaciones y el formato del separador de barra vertical, y señala los problemas con la fila y la columna exactas.

Abrir el corrector de CSV de WooCommerce | Ver la plantilla de WooCommerce