Item group ID [item_group_id]

An example ad showing a shoe with different color variants

Use the item group ID [item_group_id] attribute to group product variants in your product data. Variants are a group of similar products that only differ from one another by product details like size [size], colour [color], material [material], pattern [pattern], age group [age_group] and gender [gender].

When you use an item group ID [item_group_id] to group your products, you can ensure that your product and its variants are shown to customers as a group, instead of separately.

Setting up item groups in your feed

For subtitles in your language, turn on YouTube captions. Select the settings icon at the bottom of the video player, then select 'Subtitles/CC' and choose your language.

When to use

Required for free listings for product variants

Required for Shopping ads for product variants targeting the following countries:

Brazil
France
Germany
Japan
United Kingdom
United States

Format

Follow these formatting guidelines to make sure that Google understands the data that you're submitting.

For details on when and how to submit values in English, learn more about submitting your product data.

Type	Unicode characters (recommended: ASCII only): alphanumerical, underscores and dashes
Limits	1-50 characters
Repeated field	No
Schema.org property (What's this?)	`Product.inProductGroupWithID`, Type: `Text`

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

To format your data for Content API, have a look at the Content API for Shopping.

Guidelines

Follow these guidelines to make sure that you submit high quality data for your products.

Minimum requirements

These are the requirements that you'll need to meet to show your product. If you don't follow these requirements, we'll disapprove your product and let you know on the Diagnostics page of your Merchant Center account.

Submit a unique ID for each different product.Use the same value for item group ID [item_group_id] attribute for all variants of the same product. For example, a T-shirt comes in 9 variants: 3 sizes (small, medium, large) and 3 colours (red, blue, green). Submit each variant as a separate product (for a total of 9 separate products), and submit the same value for the item group ID attribute for each to indicate that these are variants of the same product.
Each distinct item group must have a unique value for the item group ID [item_group_id]attribute.
- Don't rely on casing to make the item group ID unique. The values 'abc123' and 'ABC123' are interpreted as the same product.
- Don't reuse or recycle the same item group ID attribute for different products.
Submit a variant attribute along with the item group ID attribute. When you submit an item group ID, make sure that your variants use at least one of the variant attributes: colour [color], pattern [pattern], material [material], age group [age_group], gender [gender], size[size].
Use the same variant attributes for all products with the same item group ID. For example, if you submit a dress in 2 colours and 2 sizes, each product you submit must provide a value for the colour [color] attribute and the size [size] attribute. Don't just provide the colour or size for one dress, but not the others.
Make sure that the product details displayed on your landing page match the values you provide for each attribute like title [title], colour [color], pattern [pattern], material [material],price [price], availability [availability] and image link [image_link]. Learn more about requirements for landing pages

Best practices

These best practices can help you go beyond the basic requirements to optimise your product data for performance.

Use the parent SKU as the item group ID value 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 the item group ID [item_group_id] attribute for all products in the variant group.
Don't mix up 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 a value for the item group ID attribute if your product is not a variant. If your product is similar to other products, but not specifically a variant, don't submit the item group ID attribute. Some examples of products that are not variants include a suit consisting of a jacket and pants or a set of bath accessories.
Use a stable item group ID value for each group of product variants. Once you've assigned an item group ID to a product, don't change it. If the item group ID changes often, it could cause inconsistency in the way variants are grouped and shown to customers.
Don't use the item group ID attribute 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 the item group ID attribute to indicate your variants. Review best practices for submitting unsupported variants
To group and display product variants to customers on Buy on Google, make sure to add both the item group ID [item_group_id] attribute and a valid GTIN [gtin] to each variant of your product. If you're a manufacturer or brand owner, you can sign up for Google Manufacturer Center, which allows manufacturers and brands to submit authoritative product data such as GTIN [gtin]. Learn more about GTINs

Examples

General examples

Submit variant details through the variant attributes. For example:

Product data for red Google logo T-shirt, size small
Attribute	Value
Title `[title]`	Google Logo T-shirt – Small – Red
ID `[id]`	12345-S-R
Colour `[color]`	Red
Size `[size]`	Small
Item group ID `[item_group_id]`	12345

Product data for blue Google logo T-shirt, size medium
Attribute	Value
Title `[title]`	Google Logo T-shirt – Medium – Blue
ID `[id]`	12345-M-B
Colour `[color]`	Blue
Size `[size]`	Medium
Item group ID `[item_group_id]`	12345

Don't submit variants without variant attributes.

Clothing products

Clothing products typically come in variants. Use the same item group ID [item_group_id] for each variant. Here's an example that comes in two colours, each in three sizes.

Note: The gender [gender] attribute may be mandatory depending on the target country and is required in order for variant attributes to be displayed accurately.

For this example, you would submit the following six variants:

Product data for white Google logo T-shirt, size small
Attribute	Value
Title `[title]`	Google Logo T-shirt – Small – White
ID `[id]`	12345-S-W
Colour `[color]`	White
Size `[size]`	Small
Item group ID `[item_group_id]`	12345

Product data for black Google logo T-shirt, size small
Attribute	Value
Title `[title]`	Google Logo T-shirt – Small – Black
ID `[id]`	12345-S-B
Colour `[color]`	Black
Size `[size]`	Small
Item group ID `[item_group_id]`	12345

Product data for white Google logo T-shirt, size medium

Attribute	Value
Title `[title]`	Google Logo T-shirt – Medium – White
ID `[id]`	12345-M-W
Colour `[color]`	White
Size `[size]`	Medium
Item group ID `[item_group_id]`	12345

Product data for black Google logo T-shirt, size medium
Attribute	Value
Title `[title]`	Google Logo T-shirt – Medium – Black
ID `[id]`	12345-M-B
Colour `[color]`	Black
Size `[size]`	Medium
Item group ID `[item_group_id]`	12345

Product data for white Google logo T-shirt, size large
Attribute	Value
Title `[title]`	Google Logo T-shirt – Large – White
ID `[id]`	12345-L-W
Colour `[color]`	White
Size `[size]`	Large
Item group ID `[item_group_id]`	12345

Product data for black Google logo T-shirt, size large
Attribute	Value
Title `[title]`	Google Logo T-shirt – Large – Black
ID `[id]`	12345-L-B
Colour `[color]`	Black
Size `[size]`	Large
Item group ID `[item_group_id]`	12345

Shoes

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

Product data for blue, orange and green low-top shoes, size 8 narrow
Attribute	Value
Title `[title]`	Low-Top Shoes – 8 Narrow
ID `[id]`	12460-8b-blu
Colour `[color]`	Blue/orange/green
Size `[size]`	8B
Item group ID `[item_group_id]`	12345

Product data for blue, orange and green low-top shoes, size 8
Attribute	Value
Title `[title]`	Low-Top Shoes – 8
ID `[id]`	12460-8-blu
Colour `[color]`	Blue/orange/green
Size `[size]`	8
Item group ID `[item_group_id]`	12345

Product data for low-top shoes blue/orange/green, 8 wide
Attribute	Value
Title `[title]`	Low-Top Shoes – 8 – Wide
ID `[id]`	12460-8w-blu
Colour `[color]`	Blue/orange/green
Size `[size]`	8W
Item group ID `[item_group_id]`	12345

Electronics

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

An illustration with 3 different colors of one mobile phone

Product data for a blue Google Nexus 6, 32 GB, unlocked

Attribute	Value
Title `[title]`	Google Nexus 6 – 32 GB – Midnight Blue – Unlocked
ID `[id]`	2345-32gb-midblu
Colour `[color]`	Midnight Blue
Item group ID `[item_group_id]`	2345

Product data for a white Google Nexus 6, 32 GB
Attribute	Value
Title `[title]`	Google Nexus 6 – 32 GB – Cloud White – With contract
ID `[id]`	2345-32gb-cldwh
Colour `[color]`	Cloud White
Item group ID `[item_group_id]`	2345

Furniture

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

An illustration of a couch with product staging

Product data for mid-century microfibre sofa, yellow and grey dot pattern
Attribute	Value
Title `[title]`	Mid-Century Microfibre Sofa – Dot Pattern – Yellow and Grey
ID `[id]`	3456-dot-yllw-gry
Colour `[color]`	Yellow/grey
Material `[material]`	Suede
Item group ID `[item_group_id]`	3456

Product data for mid-century microfibre sofa, green leather
Attribute	Value
Title `[title]`	Mid-Century Microfibre Sofa – Leather – Green
ID `[id]`	3456-lth-grn
Colour `[color]`	Green
Material `[material]`	Leather
Item group ID `[item_group_id]`	3456

Product data for a walnut-coloured plywood lounge chair
Attribute	Value
Title `[title]`	Moulded Plywood Lounge Chair – Walnut
ID `[id]`	1a2b3c-wal
Colour `[color]`	Walnut
Material `[material]`	Plywood
Item group ID `[item_group_id]`	1a2b3c

Product data for an ash-coloured plywood lounge chair
Attribute	Value
Title `[title]`	Moulded Plywood Lounge Chair – Ash
ID `[id]`	1a2b3c-ash
Colour `[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 colours, you could submit each colour as a variant by using the same value for the item group ID [item_group_id] attribute.

Product data for beige liquid makeup
Attribute	Value
Title `[title]`	Blend Liquid Makeup – Beige
ID `[id]`	0987-b
Colour `[color]`	Beige
Item group ID `[item_group_id]`	0987

Product data for liquid makeup, beige-medium
Attribute	Value
Title `[title]`	Blend Liquid Makeup – Beige Medium
ID `[id]`	0987-bmed
Colour `[color]`	Beige medium
Item group ID `[item_group_id]`	0987

Groceries

Groceries can be submitted as variants. For example, let's say you're selling bags of basmati rice that come in different sizes and are sold by weight. You could submit each item as a variant by using the same value for the item group ID [item_group_id] attribute.

Product data for basmati rice, extra long grain
Attribute	Value
Title `[title]`	Basmati Rice – Extra Long Grain
ID `[id]`	575185159
Item group ID `[item_group_id]`	123456
Price `[price]`	11.20 GBP
Unit pricing measure `[unit_pricing_measure]`	5 lbs
Unit pricing base measure `[unit_pricing_base_measure]`	1 lb