¿Qué es ProductGroup en Schema.org?
ProductGroup es el tipo de Schema.org que agrupa las variantes de un mismo producto, las versiones que solo cambian en aspectos como la talla, el color o el material. El grupo no se vende: hace de plantilla con lo que comparten todas, dice en qué varían y enlaza cada variante, que es un Product con su propia oferta e identificador.
Lo esencial
- ProductGroup es el producto padre en el marcado: no se compra, pero reúne lo común a todas sus variantes, como la marca o la descripción general.
- Google le pide un nombre, recomienda variesBy, hasVariant y productGroupID, y exige un identificador único por variante y por grupo.
- En una ficha única con selector, el grupo tiene una sola URL canónica; si cada variante tiene su página, el grupo entero se repite en cada una.
- Cada variante tiene que poder abrirse ya seleccionada desde su propia URL, con su imagen, su precio, su disponibilidad y su botón de compra.
Una camisa que se vende en dos colores y tres tallas son seis cosas que se pueden comprar, y una sola idea de producto: la camisa. En el marcado, cada una de las seis es un Product y la idea que las reúne es un ProductGroup. Es un tipo de Schema.org y se escribe en inglés porque es un nombre del vocabulario. El ProductGroup no se vende: es el padre que dice qué tienen en común las variantes y en qué se diferencian. Te importa porque es la forma que tiene Google de entender que seis fichas de producto, o seis opciones dentro de una sola, son el mismo artículo y no seis productos que compiten entre sí. Lo que es una variante en tu catálogo, y cuándo una talla o un pack lo son, lo explica la entrada de variantes de producto; aquí va el tipo que las describe en los datos estructurados.
Cómo funciona
Schema.org define ProductGroup como un grupo de productos que solo varían en aspectos bien descritos, como la talla, el color o el material, y lo cuelga de Product: es un tipo de producto. Añade una precisión que explica su diseño: el grupo en sí no se ofrece a la venta, pero las variantes que representa sí. Funciona como un prototipo o una plantilla, y las propiedades que se ponen en el grupo representan características que comparten todas sus variantes, salvo tres que solo son del grupo: variesBy, hasVariant y url.[1]Schema.org. ProductGroup
Sus propiedades propias son tres. hasVariant apunta a cada variante, y su inversa, isVariantOf, permite que la variante apunte al grupo. productGroupID es un identificador de texto para el grupo. variesBy dice en qué propiedades varían las variantes, por ejemplo la talla o el color.[1]Schema.org. ProductGroup
Google añadió su documentación de variantes el 20 de febrero de 2024, junto con la propiedad isVariantOf en la de producto, y aclaró entonces que admite variantes con URL distintas.[2]Google Search Central. Latest documentation updates Según esa documentación, el marcado de variantes hace que tus productos puedan mostrarse con la información de sus variantes en las experiencias de fichas de comerciante, y poner en el grupo lo común, como la marca o las reseñas, reduce la información repetida.[3]Google Search Central. Product variant (ProductGroup, Product) structured data Lo que pide del grupo:
| Propiedad | Qué dice Google |
|---|---|
name |
Obligatoria. El nombre del grupo, como «Abrigo de lana», y en cada variante uno más concreto, como «Abrigo de lana, verde, talla S» |
productGroupID |
Recomendada. El identificador del grupo, también llamado SKU padre. Si también lo das en cada variante con inProductGroupWithID, tiene que coincidir |
variesBy |
Recomendada. Las propiedades que diferencian las variantes, con su URL completa de Schema.org: color, talla, edad recomendada, sexo recomendado, material y patrón |
hasVariant |
Recomendada. Cada variante como un Product anidado; o, al revés, cada variante apunta al grupo con isVariantOf |
brand, description, review, aggregateRating |
Recomendadas cuando son iguales para todas las variantes. La marca puesta en el grupo no hace falta repetirla en cada una |
url |
Solo en tiendas de una única página: la URL del grupo sin ninguna variante elegida |
Tabla según la documentación de variantes de Google.[3]Google Search Central. Product variant (ProductGroup, Product) structured data Desde el 20 de mayo de 2026, esa documentación incluye además hasAdultConsideration, para marcar productos de contenido adulto.[2]Google Search Central. Latest documentation updates
Google distingue dos diseños de tienda. En el de una sola página, todas las variantes se eligen sin recargar, normalmente con parámetros en la URL, y el grupo tiene una única URL canonical, la que no lleva ninguna variante preseleccionada. En el de varias páginas, cada variante o cada color tiene su página; entonces no hay una URL que represente al grupo, y la definición completa del grupo se repite en cada página, porque tiene que llevar lo común a todas. Cada página lleva el marcado completo de sus propias variantes y, para las de otras páginas, una variante que solo lleva url, para que Google pueda encontrarlas.[3]Google Search Central. Product variant (ProductGroup, Product) structured data En los dos diseños, las variantes pueden ir anidadas dentro del grupo o por separado; Google recomienda anidarlas en una página única porque es la representación más compacta y natural, y admite las otras porque algunos gestores de contenido las generan con más facilidad.[3]Google Search Central. Product variant (ProductGroup, Product) structured data
Y dos condiciones técnicas que deciden si el marcado sirve. Cada variante necesita un identificador único, con sku o gtin (GTIN), y cada grupo el suyo. Y la tienda tiene que poder abrir cada variante ya seleccionada desde una URL propia, con la imagen, el precio y la disponibilidad de esa variante y la opción de añadirla al carrito, para que Google pueda rastrearla e identificarla.[3]Google Search Central. Product variant (ProductGroup, Product) structured data
En una tienda
Ejemplo ficticio. Una tienda inventada tiene una página por color de su camisa de lino, y la talla se elige en cada página con un parámetro. Este es el marcado de la página azul, recortado: el grupo completo, sus dos variantes azules y una variante con solo la URL de la página blanca. La página blanca repetiría el mismo grupo con sus variantes blancas y un enlace de vuelta a las azules.
{
"@context": "https://schema.org",
"@type": "ProductGroup",
"name": "Camisa de lino Calella",
"description": "Camisa de lino de manga larga, corte recto.",
"brand": { "@type": "Brand", "name": "Calella" },
"productGroupID": "CAL-LINO",
"variesBy": ["https://schema.org/color", "https://schema.org/size"],
"hasVariant": [
{
"@type": "Product",
"sku": "CAL-LINO-AZ-M",
"name": "Camisa de lino Calella, azul, M",
"color": "Azul",
"size": "M",
"offers": {
"@type": "Offer",
"url": "https://www.example.com/camisa-lino/azul?talla=m",
"price": "39.90",
"priceCurrency": "EUR",
"availability": "https://schema.org/InStock"
}
},
{
"@type": "Product",
"sku": "CAL-LINO-AZ-L",
"name": "Camisa de lino Calella, azul, L",
"color": "Azul",
"size": "L",
"offers": {
"@type": "Offer",
"url": "https://www.example.com/camisa-lino/azul?talla=l",
"price": "39.90",
"priceCurrency": "EUR",
"availability": "https://schema.org/InStock"
}
},
{ "url": "https://www.example.com/camisa-lino/blanca?talla=m" }
]
}
Tres cosas que se leen en él. El grupo no lleva url, porque en una tienda de varias páginas no tiene una propia. La marca y la descripción general van una vez, en el grupo, y valen para todas las variantes. Y el precio va en la oferta de cada variante, nunca en el grupo, porque el grupo no se vende.
Lo que se suele confundir
Poner el precio y la disponibilidad en el ProductGroup, como si fuera el producto que se compra. Schema.org es explícito: el grupo no se ofrece a la venta, lo que se vende son sus variantes.[1]Schema.org. ProductGroup La oferta va dentro de cada variante, con su precio y sus existencias, y el grupo se queda con lo que no cambia.
Cómo comprobarlo
- Abre el código fuente de una ficha con variantes y busca
"@type": "ProductGroup". Comprueba que tienename,variesByyproductGroupID, y que cada variante tiene suskuo sugtinsin repetirse.[3]Google Search Central. Product variant (ProductGroup, Product) structured data - Si hay
inProductGroupWithIDen las variantes, comprueba que coincide con elproductGroupIDdel grupo.[3]Google Search Central. Product variant (ProductGroup, Product) structured data - Abre la URL de cada variante en una ventana privada y mira si la página carga con esa variante elegida: su imagen, su precio, su disponibilidad y el botón de compra activo.[3]Google Search Central. Product variant (ProductGroup, Product) structured data
- Si tu tienda tiene una página por variante o por color, abre dos y comprueba que las dos llevan el grupo completo y un enlace a las variantes de la otra.[3]Google Search Central. Product variant (ProductGroup, Product) structured data
- Comprueba qué resultados enriquecidos ve Google: pasa la URL por la Prueba de resultados enriquecidos y mira si encuentra las variantes y con qué errores o advertencias.
Concepto cercano: variantes de producto
Las variantes de producto son una idea del catálogo y ProductGroup es su descripción en el marcado. Las variantes viven en tu plataforma, con sus opciones, su inventario y sus códigos; ProductGroup es cómo se las cuentas a un buscador. Lo primero se decide al dar de alta el producto, y lo segundo tiene que reflejarlo sin inventar nada: si la tienda vende nueve combinaciones, el grupo enlaza nueve variantes. La entrada de variantes de producto explica cómo se modelan en las plataformas y en Google Merchant Center, y dónde termina una variante y empieza otro producto.
Para seguir, la ruta de lectura de datos estructurados ordena el resto de términos, y la entrada de Offer explica qué lleva la oferta de cada variante.
Sinónimos
- English
- product group schema, product variant structured data
- Español
- grupo de productos, marcado de variantes
Fuentes
Historial de cambios
- Primera versión.
Esta definición se publica bajo licencia CC BY 4.0. Puedes reutilizar esta definición citando a Clione con un enlace a esta página.
Términos relacionados
Variantes de producto
Qué son las variantes de producto, cómo las modelan Shopify, Google y Merchant Center, y cuándo una talla o un color es variante y no otro producto.
Product
Qué es el tipo Product de Schema.org, qué propiedades lleva, qué pide Google para fragmentos de producto y fichas de comerciante, y cómo contrastarlo.
Offer
Qué es el tipo Offer de Schema.org, cómo se escriben el precio, la moneda y la disponibilidad, qué pide Google y en qué se diferencia de AggregateOffer.
SKU
Qué es el SKU de un producto, en qué se diferencia del GTIN y del MPN, cómo crear uno por variante en Shopify o BigCommerce y dónde lo pide Google.
GTIN
Qué es el GTIN, sus formatos (GTIN-13 o EAN, GTIN-12, GTIN-8, GTIN-14), quién lo asigna, cómo va en una ficha y por qué nunca se inventa.
Canonical
Qué es la etiqueta canonical, cómo la usa Google para elegir la URL de una ficha con varias direcciones y cómo comprobar cuál ha elegido en tu tienda.
Haz que los bots entiendan tu catálogo
Clione completa cada ficha de producto con lo que los bots leen mejor: el grafo JSON-LD con sus datos estructurados, la meta description y las preguntas frecuentes. Tú revisas y pulsas Push; después comprobamos tu tienda en vivo para que todo siga publicado.