Google product variant structured data

The Google product variant guidance,
as documented

What Google documents, in its own words. Verified from Google's page on 2026-10-09.

Google's page explains how ProductGroup groups variants of one product and which technical rules apply. This page lists those statements with the exact wording from Google.

What Google says

TopicWhat Google saysSource
Scope “To help Google better understand which products are variations of the same parent product, use the ProductGroup class with associated properties variesBy, hasVariant, and productGroupID to group such variants together, in addition to Product structured data.” Google docs
Verified 2026-10-09
Eligibility “Adding this markup also makes your products eligible for display with variant information in merchant listing experiences.” Google docs
Verified 2026-10-09
Shared info “ProductGroup also lets you specify common product-properties for all variants, such as brand and review information, as well as the variant-determining properties, which can reduce the duplication of information.” Google docs
Verified 2026-10-09
Variant ID “Each variant must have a unique ID in its corresponding structured data markup (for example, using the sku or gtin properties).” Google docs
Verified 2026-10-09
Group ID “Each product group must have a unique ID in its corresponding structured data markup, specified with the inProductGroupWithID property in variant Product properties or the productGroupID property in the ProductGroup property.” Google docs
Verified 2026-10-09
Product too “Be sure to add Product structured data in addition to the product variant properties, following the list of required properties for merchant listings (or product snippets).” Google docs
Verified 2026-10-09
Single-page canonical “For single-page sites, there must be only one distinct canonical URL for the overall ProductGroup that all variants belong to.” Google docs
Verified 2026-10-09
Multi-page “For multi-page sites, each page must have full and self-contained markup for the entities defined on that page” Google docs
Verified 2026-10-09
Variant URLs “The site must have the ability to preselect each variant directly with a distinct URL (using URL query parameters), for example https://www.example.com/winter_coat/size=small&color=green.” Google docs
Verified 2026-10-09
Preselect “Preselecting each variant includes showing the right image, price, and availability, as well as allowing the user to add the variant to the cart.” Google docs
Verified 2026-10-09
Initial HTML “If you're a merchant optimizing for all types of shopping results, we recommend putting Product structured data in the initial HTML for best results.” Google docs
Verified 2026-10-09
JavaScript “Be aware that dynamically-generated markup can make Shopping crawls less frequent and less reliable, which can be an issue for fast-changing content like product availability and price.” Google docs
Verified 2026-10-09
variesBy “Aspects by which the variants in the ProductGroup vary, (for example, size or color), if applicable.” Google docs
Verified 2026-10-09
No guarantee “Google does not guarantee that features that consume structured data will show up in search results.” Google docs
Verified 2026-10-09

Read on 2026-10-09. Google's page showed "Last updated 2026-09-08 UTC". Notes under a quote are close paraphrases of the same page. This page covers only what Google documents.

How to apply it

A checklist built only from the guidance in Google's page.

  1. Give every variant a unique ID such as sku or gtin.
  2. Give every product group a unique ID with productGroupID or inProductGroupWithID.
  3. Add Product structured data in addition to the variant properties.
  4. Make each variant selectable with its own URL.
  5. Put Product structured data in the initial HTML where you can.

Related: Google product snippet structured data, Google structured data guidelines, Google canonical URL signals.

Questions

Does each variant need its own ID?

Yes. Google says each variant must have a unique ID in its structured data markup, for example using the sku or gtin properties.

Do I still need Product markup?

Yes. Google says to add Product structured data in addition to the product variant properties.

Can variants share one URL?

Google says the site must be able to preselect each variant directly with a distinct URL using URL query parameters.

Is variant markup guaranteed to show?

No. Google says it does not guarantee that features that consume structured data will show up in search results.

How current is this page?

Every quote was read from Google's page on 2026-10-09. The page showed "Last updated 2026-09-08 UTC". Google can change its documentation, so treat the linked page as the final word.

Sources

Let Balzac write the articles.

Type your website. Balzac finds the searches you can win, writes articles built to rank on Google and get cited by ChatGPT, and publishes them for you.

3 free articles · No card needed