Primero decida si cada talla y color se puede elegir en una sola página de producto o si cada variante tiene su propia URL. Esa decisión fija la URL canónica y la forma de su JSON-LD. Después, el marcado sigue un solo patrón: un ProductGroup para el producto compartido y un Product por cada variante que el comprador puede adquirir.

Las piezas se conectan mediante productGroupID, hasVariant y variesBy. Cada variante también conserva los datos normales de producto: un nombre, una imagen, un identificador único como sku y una oferta con precio y moneda.

Antes de escribir código, revise lo que ya genera su plataforma de tienda. Shopify y WooCommerce generan marcado de producto, y un segundo bloque que no coincida con el primero puede dejarle dos descripciones del mismo artículo.

Puntos clave

  1. Elija el modelo de páginaDecida si cada variante se puede seleccionar en una sola página o si cada una tiene su propia URL. Esa elección fija la URL canónica y la forma del JSON-LD.
  2. Enlace el grupo y las variantesUse un ProductGroup para el producto compartido y un Product para cada variante que un comprador pueda adquirir, enlazados mediante productGroupID, hasVariant y variesBy.
  3. Identifique cada varianteDé a cada variante comprable su propio sku u otro identificador único, y enumere las propiedades que las distinguen en variesBy con URL completas de Schema.org.
  4. Incluya los datos completos del productoCada variante necesita también los datos del producto: nombre, imagen y un Offer con precio y moneda. ProductGroup solo no da a Google Search los datos completos del producto.
  5. Revise la salida de la plataformaShopify indica que su filtro muestra variantes como ProductGroup, y el marcado estándar de WooCommerce genera un bloque agregado. Revise el HTML de cada página antes de añadir más.
  6. Pruebe en ordenValide el JSON-LD, pruebe la página publicada y luego revise los informes. Una prueba limpia no garantiza un listado de comerciante ni la visualización de una variante.

Elija primero una sola página o páginas separadas

Abra una de sus páginas de producto y seleccione una talla. ¿Cambia la URL, y la página muestra la imagen, el precio y el estado de existencias que corresponden? Si cada variante se puede seleccionar en esa misma página, tiene una configuración de página única. Si cada variante vive en su propia dirección, por ejemplo una página por color, tiene una configuración de varias páginas.

En una configuración de página única, la documentación de Google sobre variantes de producto indica mantener una URL canónica para el grupo completo, como https://example.com/linen-shirt, y dar a cada variante seleccionable una URL distinta, como ?color=navy&size=m. Cada una de esas URL debe mostrar la imagen, el precio, la disponibilidad y el estado del botón de agregar al carrito que correspondan.

En una configuración de varias páginas, cada página de variante tiene su propia URL y el grupo no tiene una única URL canónica. En su lugar, cada página de variante incluye una definición de grupo autocontenida, de modo que la página se entiende sin el marcado de ninguna otra página.

Todo lo demás del JSON-LD depende de esta elección, así que resuélvala antes de tocar el código.

Qué significan el grupo, las variantes y cada propiedad

ProductGroup describe el modelo compartido: el diseño de la camisa en conjunto. Schema.org lo describe como un prototipo o plantilla para productos que varían según dimensiones especificadas. No es el artículo que el comprador pone en el carrito. Cada Product es ese artículo, por ejemplo la camisa azul marino en talla mediana. Google agregó compatibilidad con variantes de producto el 20 de febrero de 2024, y su anuncio de lanzamiento nombra ProductGroup, hasVariant, variesBy y productGroupID como los elementos básicos.

Cinco propiedades hacen el trabajo de conexión:

  • hasVariant va del grupo a una variante, y isVariantOf va en sentido inverso, de una variante a su grupo.
  • variesBy enumera las propiedades que distinguen a las variantes. La documentación de Google incluye las URL completas de Schema.org https://schema.org/color, https://schema.org/size, https://schema.org/suggestedAge, https://schema.org/suggestedGender, https://schema.org/material y https://schema.org/pattern.
  • productGroupID es un identificador de texto estable para el grupo, como un SKU principal. Google exige el identificador del grupo, ya sea aquí o mediante inProductGroupWithID en cada variante.
  • inProductGroupWithID va en una variante y contiene el productGroupID del grupo. Ayuda cuando las variantes y el grupo son entidades separadas o están en páginas distintas.
  • sku da a cada variante su propio identificador, para que una camisa azul marino talla mediana nunca se confunda con una de color arena talla grande.

Una forma sencilla de separar los datos: los detalles compartidos, como brand y una description general, van en el grupo cuando se aplican por igual a todas las variantes. Todo lo que cambia, como color, size, image, sku y la oferta, va en cada variante.

Imagine una mesa larga cubierta de camisetas lisas dobladas, ordenadas en pilas por talla y color. La mesa es el grupo, y cada pila es una variante que se puede contar, poner precio y vender por separado. El marcado describe exactamente esa clasificación, y solo funciona cuando cada pila tiene su propia etiqueta.

Un hombre barbado con camiseta gris ordena camisetas lisas dobladas en pilas por talla y color sobre una mesa larga
Figura 1. Ordenar camisetas en pilas por talla y color refleja cómo se describen un grupo y sus variantes.

Incluya también los datos normales de Product en cada variante. ProductGroup por sí solo no entrega a Google Search los datos completos del producto que necesita, así que el nombre, la imagen y la oferta también deben estar presentes.

JSON-LD de página única para una camisa con dos variantes

El ejemplo siguiente describe una camisa ficticia en una sola página. Usa URL de example.com y nombres inventados, y anida dos variantes dentro de hasVariant. Es la forma compacta; también puede colocar las variantes como entidades separadas y conectarlas con isVariantOf y @id, como hace también este ejemplo además de anidarlas.

json
{
  "@context": "https://schema.org",
  "@type": "ProductGroup",
  "@id": "https://example.com/linen-shirt#group",
  "name": "Harbor Linen Shirt",
  "description": "Una camisa de lino ficticia disponible en azul marino y arena, en tallas mediana y grande.",
  "url": "https://example.com/linen-shirt",
  "brand": {
    "@type": "Brand",
    "name": "Example Harbor"
  },
  "productGroupID": "HLS-100",
  "variesBy": [
    "https://schema.org/color",
    "https://schema.org/size"
  ],
  "hasVariant": [
    {
      "@type": "Product",
      "@id": "https://example.com/linen-shirt#navy-medium",
      "name": "Harbor Linen Shirt, Navy, Medium",
      "image": "https://example.com/images/harbor-linen-shirt-navy.jpg",
      "sku": "HLS-100-NV-M",
      "color": "Navy",
      "size": "M",
      "isVariantOf": {
        "@id": "https://example.com/linen-shirt#group"
      },
      "offers": {
        "@type": "Offer",
        "url": "https://example.com/linen-shirt?color=navy&size=m",
        "price": 49.99,
        "priceCurrency": "USD",
        "availability": "https://schema.org/InStock"
      }
    },
    {
      "@type": "Product",
      "@id": "https://example.com/linen-shirt#sand-large",
      "name": "Harbor Linen Shirt, Sand, Large",
      "image": "https://example.com/images/harbor-linen-shirt-sand.jpg",
      "sku": "HLS-100-SD-L",
      "color": "Sand",
      "size": "L",
      "isVariantOf": {
        "@id": "https://example.com/linen-shirt#group"
      },
      "offers": {
        "@type": "Offer",
        "url": "https://example.com/linen-shirt?color=sand&size=l",
        "price": 54.99,
        "priceCurrency": "USD",
        "availability": "https://schema.org/InStock"
      }
    }
  ]
}

Reemplace cada valor con un dato de su propia página de producto. Eso incluye el @id, name, url y brand del grupo, el productGroupID y, para cada variante, el nombre, la dirección de la imagen, el sku, color, size, la URL de la oferta, el precio, la moneda y la disponibilidad. Los precios aquí difieren entre variantes a propósito: si sus variantes cuestan lo mismo, repita el mismo precio en cada una.

Haga que cada valor coincida con lo que ve el comprador. Si la página visible indica que la camisa color arena talla grande está agotada, la oferta debe indicar https://schema.org/OutOfStock. Agregue itemCondition, una description más larga para cada variante y un gtin real cuando disponga de ellos; Google los indica como recomendados para las fichas de comerciante. Omita las calificaciones, las reseñas y los identificadores que no tenga, porque los valores inventados describen un producto que no existe.

La sintaxis sigue la Recomendación W3C de JSON-LD 1.1. Coloque el bloque en un elemento script de tipo application/ld+json en el HTML de la página.

JSON-LD de varias páginas, una página por variante

Cuando cada variante tiene su propia página, cada página vuelve a incluir el grupo, sin url en el grupo, porque el grupo no tiene una página propia. La página de azul marino talla mediana describe esa variante por completo y enumera la otra variante con su URL y su sku. La documentación de Google indica incluir por completo las variantes presentes en la página y enlazar las variantes que están en otras páginas con elementos de Product que contengan sus URL.

json
{
  "@context": "https://schema.org",
  "@type": "ProductGroup",
  "name": "Harbor Linen Shirt",
  "description": "Una camisa de lino ficticia disponible en azul marino y arena, en tallas mediana y grande.",
  "brand": {
    "@type": "Brand",
    "name": "Example Harbor"
  },
  "productGroupID": "HLS-100",
  "variesBy": [
    "https://schema.org/color",
    "https://schema.org/size"
  ],
  "hasVariant": [
    {
      "@type": "Product",
      "name": "Harbor Linen Shirt, Navy, Medium",
      "url": "https://example.com/linen-shirt/navy-medium",
      "image": "https://example.com/images/harbor-linen-shirt-navy.jpg",
      "sku": "HLS-100-NV-M",
      "color": "Navy",
      "size": "M",
      "offers": {
        "@type": "Offer",
        "url": "https://example.com/linen-shirt/navy-medium",
        "price": 49.99,
        "priceCurrency": "USD",
        "availability": "https://schema.org/InStock"
      }
    },
    {
      "@type": "Product",
      "name": "Harbor Linen Shirt, Sand, Large",
      "url": "https://example.com/linen-shirt/sand-large",
      "sku": "HLS-100-SD-L"
    }
  ]
}

Cambie en cada página la URL de la página y el bloque completo de la variante, y mantenga idénticos en todo el conjunto el productGroupID, variesBy y la lista de las demás variantes. Cada variante necesita aun así su propio sku u otro identificador único. No dependa de un grupo definido en otra página; cada página de variante debe tener sentido por sí sola.

Una tarjeta de página con varias muestras de color a la izquierda, y tres tarjetas de página separadas, cada una unida a un nodo principal compartido, a la derecha
Figura 2. Las variantes pueden compartir una sola página o tener cada una su propia página, y la estructura del marcado sigue esa elección.

Propiedades obligatorias y recomendadas para funciones de Google

Las etiquetas de Google dependen de la función a la que apunte, así que identifique la función antes de leer cualquier etiqueta. Para el marcado de variantes de producto, Google exige name y hasVariant en el grupo cuando usa la forma anidada, además del identificador del grupo mediante productGroupID o inProductGroupWithID. Recomienda variesBy, url (solo en configuraciones de página única), brand y description en el grupo, y sku, color y size en cada variante.

En una página donde los compradores pueden adquirir el producto, la documentación de fichas de comerciante (merchant listings) exige Product.name y Product.image, además de Offer.price y priceCurrency o los campos priceSpecification equivalentes. Recomienda la disponibilidad, la condición, identificadores como gtin y mpn, los atributos de variante y una URL de oferta. En una página editorial, donde el producto no se puede comprar directamente, la documentación de fragmentos de producto (product snippets) exige Product.name y al menos uno de review, aggregateRating u offers.

Lea estas etiquetas en su contexto. Describen funciones de Google Search, no la validez de Schema.org en general, y no se aplican automáticamente a Bing, Yandex, Apple ni a los sistemas de IA. Google indica que el marcado de variantes puede hacer que los productos sean elegibles para la información de variantes en las experiencias de fichas de comerciante, pero la elegibilidad no garantiza una apariencia determinada. La documentación de Google trata el marcado de variantes como parte de la elegibilidad de productos y fichas de comerciante, así que no es, por sí solo, un resultado enriquecido independiente.

Propiedades obligatorias y recomendadas para funciones de Google

Pase el cursor o toque una fila para resaltarla. En pantallas pequeñas la tabla se desplaza de lado.

PropiedadNivel para la función de GoogleDónde va
name, hasVariant, productGroupIDObligatorias para la función de variantes de Google (forma anidada)En el ProductGroup
variesBy, brand, descriptionRecomendadas para la función de variantes de GoogleEn el ProductGroup
Nombre e imagen de ProductObligatorias para las fichas de comerciante de GoogleEn cada variante
price y priceCurrency de OfferObligatorias para las fichas de comerciante de GoogleEn la oferta de cada variante
availability, itemCondition, skuRecomendadas para las funciones de GoogleEn cada variante o en su oferta
review, aggregateRatingOpcional; solo reseñas reales y visiblesEn el producto que describen

Revise lo que ya generan Shopify, WooCommerce y otras plataformas

En Shopify, el filtro structured_data de Liquid convierte un objeto de producto en datos de Schema.org. La documentación de Shopify indica que un producto sin variantes se genera como Product, y que un producto con una o más variantes se genera como ProductGroup, con ofertas que reconocen las variantes e incluyen precio, moneda, disponibilidad y una URL de variante. Los temas y las aplicaciones pueden agregar o reemplazar JSON-LD, así que revise el HTML renderizado de una página de producto y cuente los bloques de producto antes de agregar los suyos.

WooCommerce funciona de otra manera. Sus productos variables permiten que cada variación tenga su propio SKU, precio, existencias, imagen y configuración de envío. El marcado de producto estándar genera un único bloque de producto agregado para un producto variable, que puede omitir el SKU, el GTIN, el MPN y los precios individuales de cada variación.

La documentación de datos estructurados ampliados de WooCommerce describe el marcado a nivel de variación como una función de extensión que agrega el precio, la URL, el título, la marca, la condición, el GTIN, el MPN y el SKU de cada variación. Después de cualquier cambio en el tema, en el plugin de SEO, en el feed o en una extensión, revise de nuevo el HTML de la página.

Las demás plataformas siguen la misma regla: lea lo que generan antes de agregar algo.

Wix crea un preajuste de Product para las páginas de producto de Wix Stores que puede ver o personalizar. Webflow admite marcado schema manual y generado con IA, y su sistema Ecommerce ofrece conjuntos de opciones y variantes.

En Squarespace, HubSpot, temas de WordPress y Next.js, abra el HTML final, identifique qué código de tema, plugin, módulo o aplicación emite el JSON-LD del producto, y elimine los bloques duplicados o en conflicto. Next.js es un framework, así que la aplicación o la integración de comercio genera el marcado.

Haga que el marcado de variantes sea legible para Bing y la búsqueda con IA

Bing admite Schema.org en JSON-LD, así que el mismo marcado de variantes le sirve (consulte la guía de datos estructurados de Bing). Sus directrices para webmasters indican que los datos estructurados deben reflejar el contenido visible. Yandex admite JSON-LD, Microdata y RDFa, y sus preguntas frecuentes sobre marcado semántico indican que la página también debe estar indexada y puede ser moderada antes de que aparezca un fragmento.

Para que sus páginas sean elegibles para las respuestas de la búsqueda de ChatGPT, permita OAI-SearchBot en robots.txt; la documentación de rastreadores trata GPTBot como un control separado. La búsqueda web de Copilot puede obtener información de Bing. Mantenga la página rastreable y los datos de sus productos en HTML visible. Vea si los sistemas de IA usan el marcado schema.

Pruebe la página en el orden correcto

Siga la misma secuencia cada vez, desde la elección del modelo hasta la página publicada:

  1. Elija variantes de página única o de varias páginas.
  2. Asigne al grupo un productGroupID estable y único.
  3. Asigne a cada variante un sku u otro identificador único.
  4. Enumere las propiedades que distinguen a las variantes en variesBy, con URL completas de Schema.org.
  5. Describa cada variante con su nombre, atributos, imagen y oferta.
  6. Haga coincidir cada valor con los datos visibles del producto.
  7. Pruebe el JSON-LD, después la página publicada y, por último, los informes posteriores a la publicación.

Para la primera prueba, pegue el JSON-LD en el Schema Markup Validator, que solo comprueba el vocabulario de Schema.org. También puede ejecutarlo en el validador de schema de Schema Nova. Después, pruebe la página publicada con la Prueba de resultados enriquecidos (Rich Results Test) de Google y con la inspección de URL (URL Inspection) en Search Console, y revise los informes de fichas de comerciante (Merchant listings) y de fragmentos de producto (Product snippets) cuando Google rastree la página.

En Bing Webmaster Tools, la tarjeta Markup (marcado) de la inspección de URL (URL Inspection) muestra el JSON-LD detectado y los problemas de marcado. Yandex ofrece su validador de datos estructurados, que comprueba tanto el reconocimiento del marcado como los requisitos de sus servicios.

Mantenga cada advertencia junto a su resultado. Una prueba sin errores no garantiza una ficha de comerciante, una visualización de variantes ni un fragmento, y Google, Bing y Yandex lo indican cada uno respecto de sus propios resultados. Cuando una prueba informe un problema, busque primero un valor de precio o disponibilidad que no coincida con la página visible, dos bloques de producto en una misma URL y una variante con un sku faltante o repetido.

Configurar el marcado de variantes en orden

Un validador o un informe puede señalar problemas técnicos, pero no puede hacer que un motor de búsqueda muestre los datos.

  1. Elija el modelo de páginaDecida si las variantes comparten una sola página o si cada una tiene su propia URL.
  2. Asigne el ID del grupoDé al grupo principal un productGroupID estable.
  3. Asigne los ID de las variantesDé a cada variante un SKU único u otro identificador.
  4. Enumere variesByUse URL completas de Schema.org, como https://schema.org/color y https://schema.org/size.
  5. Describa cada ProductAgregue name, atributos, imagen y una oferta con precio (price), moneda, disponibilidad (availability) y URL.
  6. Valide y superviseCompare el marcado con los datos visibles, pruébelo, revise el HTML renderizado y después revise los informes.

Cree los datos de cada variante con el generador de schema de producto

Cada variante necesita su propio nombre, imagen, identificador y oferta. Use el generador de schema de producto para redactar los datos de Product de una variante, después coloque el resultado dentro de hasVariant y agregue alrededor los campos del grupo. Para las reglas más amplias sobre precio, disponibilidad y reseñas, lea la guía de marcado schema de producto, y consulte los ejemplos de schema JSON-LD de otros tipos escritos con el mismo estilo.

Preguntas frecuentes

¿Cada variante necesita su propio SKU?

Dé a cada variante comprable su propio sku u otro identificador único. Google indica que sku es recomendado para el marcado de variantes, y un valor único es lo que mantiene separadas la camisa azul marino talla mediana y la de color arena talla grande. El grupo usa productGroupID en su lugar.

¿Cuál es la diferencia entre hasVariant e isVariantOf?

Describen la misma relación desde extremos opuestos. hasVariant va en el grupo y apunta a sus variantes, mientras que isVariantOf va en una variante y apunta de regreso a su grupo. Google exige isVariantOf cuando una variante se escribe fuera de la lista hasVariant del grupo.

¿Shopify y WooCommerce generan el marcado de variantes automáticamente?

El filtro structured_data de Shopify genera un producto con variantes como ProductGroup, aunque un tema o una aplicación pueden cambiar el resultado final. El marcado estándar de WooCommerce entrega un bloque agregado para un producto variable, y el marcado a nivel de variación proviene de su extensión de datos estructurados ampliados. Revise el HTML de cada página para ver qué hay realmente.

¿Las páginas de variantes separadas necesitan JSON-LD separado?

Sí. Cada página de variante necesita una definición de grupo autocontenida, con su propia variante descrita por completo y URL para las variantes que están en otro lugar. En esta configuración, el grupo no tiene una única URL canónica.

¿El marcado de producto válido puede garantizar un resultado enriquecido?

No. El marcado válido puede hacer que una página sea elegible para una función, y cada motor de búsqueda decide qué mostrar. Google indica que la elegibilidad para la información de variantes en las fichas de comerciante no garantiza una apariencia determinada, y Bing y Yandex dicen lo mismo sobre los fragmentos.

Prueba rápida: ¿grupo o variante?

Elija una respuesta para ver comentarios. Nada se califica ni se guarda.

Pregunta 1 de 3

Una tienda vende una chaqueta en negro talla pequeña y en azul talla grande. ¿Dónde van los valores de color y talla?

Pregunta 2 de 3

¿Qué objeto representa el artículo que el comprador agrega realmente al carrito?

Pregunta 3 de 3

Cada variante tiene su propia página. ¿Qué debe contener cada página de variante?

Términos del schema de variantes

Seleccione un término para ver su definición.

ProductGroup. Un modelo principal compartido por variantes relacionadas, no el artículo que compra un cliente.