Attribute Guide
item_group_id in Google Shopping: Variant Grouping & Color Swatches Guide
Complete guide to the item_group_id attribute in Google Merchant Center. How to group product variants, enable color swatches, required distinguishing…
Cotton Crew-Neck T-Shirt — Navy
Color swatches visible in Shopping tile. All 4 color variants discoverable from one listing.
Cotton Crew-Neck T-Shirt — Navy
Each color listed as a completely separate product. No swatches. Shopper can't see that White/Grey/Black variants exist.
item_group_id is the glue that connects product variants. All sizes and colors of the same product share one item_group_id. When correctly set up with corresponding color and size attributes, Google displays color swatches directly on the Shopping tile — dramatically increasing variant visibility.
What is the item_group_id attribute?
The item_group_id attribute is a shared identifier used to group product variants together in Google Merchant Center. All size, color, and material variations of the same base product must share one item_group_id. This tells Google that these are not separate, unrelated products — they are variants of the same item, differing only in specific dimensions like color or size.
Without item_group_id, Google sees each variant as an independent product with no relationship to its siblings. This means no variant swatches, no size selectors in the product panel, potential near-duplicate content suppression, and a fragmented shopping experience. With item_group_id correctly set up, Google can display color swatches directly on the Shopping tile and present a unified variant selector — dramatically improving both discoverability and conversion.
Technical specifications
| Feed name | item_group_id |
| Required | Strongly recommended for any product sold in multiple variants |
| Max length | 50 characters |
| Format | Alphanumeric; hyphens and underscores allowed. Consistent across all variants. |
| Required companion attributes | At least one distinguishing attribute: color, size, material, or pattern |
| Scope | One item_group_id per base product. All variants of the same product share one value. |
The four distinguishing attributes
Every product sharing an item_group_id must be differentiated by at least one of these four attributes. Google uses them to distinguish variants and build the variant selector UI:
-
color— The most common variant dimension. Each color variant must have its own image showing that color, its own URL ideally pointing to the color-specific page, and a standard color name. -
size— Clothing sizes (S/M/L/XL), numeric sizes (EU 38, UK 9), or volume/capacity (250ml, 1L). Pair withsize_systemand optionallysize_type. -
material— Variants made from different materials (cotton vs. linen, steel vs. brass). Relevant for home goods, jewellery, and industrial products. -
pattern— Variants with different surface patterns (floral, striped, solid). Common in apparel, home textiles, and stationery.
Where item_group_id is used
-
Color swatches in Shopping ads — When variants share item_group_id and each has a distinct color attribute with color-matching images, Google renders small color swatches on the Shopping tile. Shoppers can see available colors before clicking, reducing the need to navigate multiple pages to find their preferred color.
-
Size selector in product detail panel — In the expanded product panel, Google shows a dropdown or toggle for available sizes when size variants are correctly grouped. Shoppers can select their size and go directly to that variant’s landing page.
-
Near-duplicate suppression prevention — Without item_group_id, Google may identify closely related products (same image, similar title, same price) as near-duplicates and suppress all but one from the auction. Grouping them via item_group_id explicitly tells Google they are intentional variants, preventing erroneous suppression.
-
Dynamic Remarketing targeting — item_group_id allows remarketing campaigns to track which specific variant a user viewed and show them that exact variant (correct color, size) in remarketing ads — significantly improving remarketing relevance and conversion rate.
Setup checklist for variant groups
-
All variants share the same
item_group_idvalue (identical string) -
Each variant has a unique
id(product-level identifier) -
Each variant has at least one unique distinguishing attribute (
color,size,material, orpattern) -
Each color variant has its own
image_linkshowing that specific color -
Each variant’s
linkpoints to a variant-specific URL (with color/size parameters) -
Each variant has accurate, independent
availability(out-of-stock variants marked separately) -
Optional but recommended:
size_systemandsize_typefor size variants
Best practices
-
Use the parent product ID as item_group_id — Most ecommerce platforms have a parent/child product model. The parent ID (before variant suffixes) is the natural item_group_id. This keeps the relationship transparent and auditable.
-
Keep item_group_id stable — Don’t change the item_group_id for an existing product group. Changing it causes Google to lose the variant relationships and can result in product disapprovals while the new group is re-evaluated.
-
Submit all in-stock and out-of-stock variants — Include OOS variants with
availability: out_of_stockrather than removing them from the feed. Removing OOS variants breaks the variant group and can suppress swatches for remaining in-stock variants. Google handles OOS variants gracefully within a group. -
One item_group_id per physical product design — If a product is fundamentally redesigned (new silhouette, different functionality), create a new item_group_id rather than adding it to the old group. The group should represent a single base product, not a product family.
-
Test swatch appearance in Merchant Center preview — After setting up variant groups, use the product preview in GMC to verify swatches appear correctly. If swatches don’t show, the most common causes are: missing color attribute on some variants, shared image URLs across variants, or landing pages that don’t link to variant-specific pages.
Impact on performance
-
CTR uplift from swatches — Color swatches in Shopping tiles consistently increase CTR by 15–25% in apparel categories. Shoppers who can see color options directly in the listing are more likely to click because they’ve already identified a color they like — reducing “window shopping” clicks from irrelevant colors.
-
Reduced wasted spend — Without item_group_id, shoppers may click on the navy variant when they actually wanted red — discovering only on the landing page that they need to navigate to the correct color. With swatches, color selection happens pre-click, reducing irrelevant clicks that don’t convert.
-
Suppression prevention — Correct item_group_id grouping prevents Google from misidentifying variants as duplicate content. Near-duplicate suppression can silently remove products from Shopping auctions without any warning in Diagnostics.
-
Remarketing precision — Variant-aware remarketing (showing the exact color/size a user viewed) can double the conversion rate of remarketing campaigns compared to generic product-level remarketing. item_group_id enables this precision.
Common mistakes
-
Using a unique item_group_id per variant instead of per product group (defeats the purpose entirely)
-
Missing item_group_id on some variants but not others (breaks the group — all variants must have it)
-
Sharing the same image_link across all color variants (swatches won’t appear — each color needs its own image)
-
All variants pointing to the same generic product URL instead of variant-specific URLs
-
Removing out-of-stock variants from the feed instead of marking them OOS (breaks the variant group)
-
Using item_group_id longer than 50 characters (silently truncated or rejected)
-
Inconsistent capitalisation or formatting of item_group_id across variants (e.g., “SKU-001” vs “sku-001” — treated as different groups)
Pro tips
-
Verify swatch rendering with GMC’s product inspector — In Merchant Center, search for a product by item_group_id and use the product inspector to see how Google renders the variant group. If swatches are missing, the inspector typically shows which condition isn’t met. This is much faster than waiting for feed re-processing to diagnose issues.
-
Include item_group_id in your supplemental price feed — Supplemental feeds for price/availability updates should also include item_group_id to prevent the grouping from being disrupted if the supplemental feed accidentally overwrites the primary feed’s grouping data with a null value.
-
Segment Performance Max by item_group_id — In Google Ads, you can use item_group_id as a product group segmentation dimension in PMax and Standard Shopping campaigns. This lets you set different bids or budgets for different product families — for example, bid higher on your premium product line than your basic line, even when they’re in the same product category.
-
For large catalogues: validate item_group_id consistency programmatically — Write a feed validation script that checks: (a) all variants with shared item_group_id have at least one differing distinguishing attribute, (b) no item_group_id appears on products with wildly different titles (which would indicate accidental grouping of unrelated products), and (c) all item_group_ids are within 50 characters. Run this on every feed generation cycle.
Frequently asked questions
What is item_group_id and when do I need it?
item_group_id is the shared identifier that tells Google which products in your feed are variants of the same base product. All color, size, and material variants of the same product must share the same item_group_id. Without it, Google treats each variant as a completely separate product with no relationship to its siblings — meaning no swatches, no size selectors, and potentially suppressed impressions due to near-duplicate content.What should I use as the item_group_id value?
SKU-001. The value must be consistent across all variants: identical string, same capitalisation. Maximum 50 characters, alphanumeric and hyphens/underscores.Which attributes are required when using item_group_id?
item_group_id must also include at least one distinguishing attribute that differentiates it from siblings: color, size, material, or pattern. If two products share the same item_group_id but have identical values for all four distinguishing attributes, Google treats them as true duplicates and may suppress one. Every variant must differ in at least one of these attributes.How does item_group_id enable color swatches?
item_group_id, (2) each has a distinct color value, (3) each has its own image_link showing that specific color, and (4) each links to a color-specific landing page. Google then renders small color dots on the Shopping tile representing available colors. This requires no additional setup — the swatches appear automatically once all four conditions are met.Can I use item_group_id for size-only variants (no color difference)?
item_group_id and differentiate with the size attribute. Google will display a size selector in the product panel rather than color swatches.What happens if variants have slightly different prices?
price, sale_price, availability, and image_link. These are product-specific attributes, not inherited from the group. item_group_id only groups the products for display purposes — it doesn't require uniform pricing or availability across variants.Should each variant have its own URL?
link attribute should point to the specific variant's URL (e.g., with a color or size parameter, or a variant-specific page). If all variants share one URL, Google can't differentiate them in the Shopping interface and may show the wrong variant image or pre-select the wrong option. Deep links to specific variants reduce post-click friction and improve conversion rates.