item group id [item_group_id]

Use the item group id [item_group_id] attribute to group product variants in your product data. Variants are a group of similar items that only differ from one another by product details like size [size], color [color], material [material], pattern [pattern], age group [age_group], size type [size_type], and size system [size_system].

When you use an item group id [item_group_id] to group your products, we recommend that your product and its variants are shown to users as a group, instead of separately.

When to use

Recommended for products with variants

Format

To make sure we understand the data you're submitting, follow these formatting guidelines:

Type: String (Unicode characters. Recommended: ASCII only)
Limits: 1–50 characters
Repeated field: No

 

File format Example value
Text feeds  AB12345
XML feeds <g:item_group_id>AB12345</g:item_group_id>
 

Guidelines

To make sure you submit high-quality data for your products, follow these requirements and best practices. 

Minimum requirements

To use this attribute to upload your product's data, follow these minimum requirements. If your attribute is disapproved, we'll notify you in the Diagnostics section of your Manufacturer Center account. 

  • Use the same value of item group id [item_group_id] for all variants of the same product. For example, a T-shirt comes in 9 variants: 3 sizes (small, medium, and large) and 3 colors (red, blue, and green). Submit each variant as a separate product (e.g. 9 separate products), and submit the same value of item group id [item_group_id] for each product to indicate that these are variants.
  • Each distinct item group must have a unique value for item group id [item_group_id].
    • Don’t rely on casing to make item_group_id unique. For example, we interpret the item group id [item_group_id] abc123 and ABC123 as the same product.
    • Each variant must differ from other variants in the item_group. However, the brand attribute should be the same across variants.
  • Submit a variant attribute along with item group id [item_group_id]. So when submitting item group id [item_group_id] , make sure that your variants use at least one of the variant attributes: color [color], size [size], material [material], etc.
  • Use the same variant attributes for all products with the same item group id [item_group_id]. For example, if you submit a dress in 2 colors and 2 sizes, each product you submit must provide a value for the color [color] attribute and the size [size] attribute. Do not just provide the color or size for one dress, but not the others.

Best practices

To optimize your product data for performance, follow these best practices: 

  • Use the parent SKU as the item group id [item_group_id] for all variants of the same product. Don't submit a parent SKU as a separate product. If you'd like to group variants using a parent SKU, use the parent SKU as the value for item group id [item_group_id] for all products in the variant group.
  • Don’t mix up item group id [item_group_id] and id attributes. Use the id attribute to uniquely identify a single product, and use item group id [item_group_id] to group together several products as variants. 
  • Don’t submit item group id [item_group_id] if your product is not a variant. If your product is similar to other products, but not specifically a variant, don’t submit item group id [item_group_id] . Some examples of products that are not variants include assorted items (a suit consisting of a jacket and pants) or any other set of dissimilar items that are sold together (a set of bath accessories). 
  • Use a stable item group id [item_group_id] for each group of product variants. Once you've assigned an item group id [item_group_id] to a product, don't change it. If item group id [item_group_id] changes often, it could cause inconsistency in the way variants are grouped and shown to users.
  • Don’t use item group id [item_group_id] for unsupported variants. If your product varies by an unsupported attribute (such as car make and model), or if your product is a build-to-order custom good with a large number of variants (more than 30), then don't use item group id [item_group_id] to indicate your variants. Review best practices for unsupported variants.

Examples

General examples

Google Manufacturer Center - checkmark Submit variant details through the variant attributes. For example:

Attribute Value
title [title] Google Logo T-shirt - Small - Red
id [id] 12345-S-R
color [color] red
size [size] s
item group id [item_group_id] 12345

 

Attribute Value
title [title] Google Logo T-shirt - Medium - Blue
id [id] 12345-M-B
color [color] blue
size [size] M
item group id [item_group_id] 12345

 

Google Manufacturer Center - x symbol Do not submit variants without variant attributes. For example, do not do this:

Attribute Value
title [title] Google Logo T-shirt - Small - Red
id [id] 12345-S-R
color [color] (no value)
size [size] (no value)
item group id [item_group_id] 12345

 

Attribute Value
title [title] Google Logo T-shirt - Small - Blue
id [id] 12345-S-B
color [color] (no value)
size [size] (no value)
item group id [item_group_id] 12345

Apparel products

Apparel products typically come in variants. Use the same item group id [item_group_id] for each variant. Here’s an example that comes in 2 colors, each in 3 sizes. For this example, you’d submit these 6 variants:

Attribute Value
title [title] Google Logo T-shirt - Small - White
id [id] 12345-S-W
color [color] white
size [size] S
item group id [item_group_id] 12345

 

Attribute Value
title [title] Google Logo T-shirt - Small - Black
id [id] 12345-S-B
color [color] black
size [size] S
item group id [item_group_id] 12345

 

Attribute Value
title [title] Google Logo T-shirt - Medium - White
id [id] 12345-M-W
color [color] white
size [size] M
item group id [item_group_id] 12345

 

Attribute Value
title [title] Google Logo T-shirt - Medium - Black
id [id] 12345-M-B
color [color] black
size [size] M
item group id [item_group_id] 12345

 

Attribute Value
title [title] Google Logo T-shirt - Large - White
id [id] 12345-L-W
color [color] white
size [size] L
item group id [item_group_id] 12345

 

Attribute Value
title [title] Google Logo T-shirt - Large - Black
id [id] 12345-L-B
color [color] black
size [size] L
item group id [item_group_id] 12345

Shoes

Submit shoes in the same way as other apparel products. Group variants of the same product by adding the same item group id [item_group_id] to each variant

Attribute Value
title [title] Low Top Shoes - 8 Narrow
id [id] 12460-8b-blu
color [color] blue/orange/green
size [size] 8B
item group id [item_group_id] 32455

 

Attribute Value
title [title] Low Top Shoes - 8 
id [id] 12460-8-blu
color [color] blue/orange/green
size [size] 8
item group id [item_group_id] 32455

 

Attribute Value
title [title] Low Top Shoes - 8 - Wide
id [id] 12460-8w-blu
color [color] blue/orange/green
size [size] 8W
item group id [item_group_id] 32455

Electronics

Electronics can be submitted as variants. For example, if a phone is available in multiple colors, you can submit each as a variant by using the same value for item group id [item_group_id] .

Google Manufacturers Center - Nexus phone

Attribute Value
title [title] Google Nexus 6 - 32 GB - Midnight Blue - unlocked
id [id] 6526-32gb-midblu
color [color] midnight blue
item group id [item_group_id] 6526

 

Attribute Value
title [title] Google Nexus 6 - 32 GB - Cloud White  - With contract
id [id] 6526-32gb-cldwh
color [color] cloud white
item group id [item_group_id] 6526

Furniture

Furniture can be submitted as variants. For example, if a couch is available in multiple fabrics, you can submit each as a variant by using the same value for item group id [item_group_id] .

Google Manufacturer Center - Pattern - 4

Attribute Value
title [title] Mid-Century Microfiber Sofa - Dot Pattern - Yellow and Gray
id [id] 3456-dot-yllw-gry
color [color] yellow/gray
material [material] suede
item group id [item_group_id] 3456

 

Attribute Value
title [title] Mid-Century Microfiber Sofa - Leather - Green
id [id] 3456-lth-grn
color [color] green
material [material] leather
item group id [item_group_id] 3456

 

Attribute Value
title [title] Molded Plywood Lounge Chair - Walnut
id [id] 1a2b3c-wal
color [color] walnut
material [material] plywood
item group id [item_group_id] 1a2b3c

 

Attribute Value
title [title] Molded Plywood Lounge Chair - Ash
id [id] 1a2b3c-ash
color [color] ash
material [material] plywood
item group id [item_group_id] 1a2b3c

Makeup

Makeup products can be submitted as variants. For example, if makeup comes in multiple colors, you could submit each color as a variant by using the same value for item group id [item_group_id] .

Attribute Value
title [title] Blend Liquid Makeup - Beige
id [id] 0987-b
color [color] beige
item group id [item_group_id] 0987

 

Attribute Value
title [title] Blend Liquid Makeup - Beige Medium
id [id] 0987-bmed
color [color] beige medium
item group id [item_group_id] 0987
Was this article helpful?
How can we improve it?