[color] attribute to describe your product's colour. This information helps create accurate filters, which customers can use to narrow search results. If your product has variants that vary by colour, use this attribute to provide that information.
When to use
Required for enhanced free listings for all Clothing Accessories (ID:166) products.
Required for Shopping ads for Clothing Accessories (ID:166) products when targeting these 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.
| Type | String (Alphanumeric, Unicode characters. Recommended: ASCII |
|---|---|
| Limits | 1-100 characters total (1-40 characters per colour) |
| Repeated field | No |
| Schema.org property (What is this?) | Product.color, Type: Text |
| File format | Example entry |
|---|---|
| Text feeds |
|
| XML feeds | <g:color>Orange Mango Explosion</g:color> |
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 the colour of your product.
- Submit only one attribute per variant. If you provide multiple colour attributes for the same variant, only one will be applied. Additional colour attributes will be discarded, and you will receive a warning.
- Use the same colour in your product data as on your landing page. For example, if you use 'Toasted Walnut' on your landing page, then submit that value in your product data. Don't submit 'Brown'.
-
Submit the colour attribute for all products that vary by colour. Use this attribute when your product is a variant that's distinguished by its colour (for example, black suede shoes and blue suede shoes), be sure to also submit each variant with the same value for the item group ID
[item_group_id]attribute for each variant of the product. - Include up to three colours. If your product is made up of several colours, you can specify 1 primary colour followed by up to 2 secondary colours that are each separated by a slash (
/). For example:Red/Green/Black. Don't submit multiple colours with a comma (,). For example, for a red shoe with green and black accents list:'Red/Green/Black'. Don't combine colours together, e.g. 'RedGreenBlack'. Don't submit multiple colours with a comma ('Red', 'Green', 'Black'). If you use commas when entering colours, only one colour will be applied. - Don't use a number as a colour such as '0 2 4 6 8'.
- Don't use characters that aren't alphanumeric such as '#fff000'.
- Include more than 1 letter and not values such as 'R'. For Chinese, Japanese or Korean languages, you can include a single character such as 红.
- Don't reference the product or image such as 'see image'.
- Don't include a value that isn't a colour such as 'variety', 'mens', 'womens', 'N/A'.
Best practices
These best practices can help you go beyond the basic requirements to optimise your product data for performance.
-
To indicate a precious metal, submit a value for the material attribute as well as a value for the colour
[color]attribute. If your product is made of a precious metal, like a gold ring, submit this information with the material[material]and colour attributes. - Include standard colour names in your title. When you submit a value for the colour attribute, submit the colour that matches the one on the landing page for that product. When submitting a value for the title
[title]attribute, pick the standard colour name that a customer would search for. For example, a customer is more likely to search for 'red dress' than 'cinnamon apple' dress.
Examples
If you describe your product on your landing page using a unique colour, like Pop Girl or High Five, submit that value through the color [colour] attribute. Then add a more standard colour name, like Red or Black, to your title.
| Product | Running shoes |
title [title] |
Running shoes – Orange – 6.5 |
size [size] |
7.5 |
color [colour] |
mango explosion |
| Product | Skater dress |
title [title] |
Black skater dress |
size [size] |
12 |
color [colour] |
nightfall |
Standard colour examples include: blue, orange, yellow, grey, red, green, black and white
Unique colour examples include: light salmon, dark tangerine, desert sand and lavender blush
If your product comes in multiple colour variants (e.g. red sunglasses and blue sunglasses). Submit each variant as a separate product, but use the same value for the item_group_id [item_group_id] attribute.
| Product | Google Malibu sunglasses |
title [title] |
Google Malibu Sunglasses – Red |
id [id] |
12345-R |
color [colour] |
red |
item group id [item_group_id] |
12345 |
| Product | Google Malibu sunglasses |
title [title] |
Google Malibu Sunglasses – Blue |
id [id] |
12345-B |
color [colour] |
blue |
item group id [item_group_id] |
12345 |
| Product | Google Malibu sunglasses |
title [title] |
Google Malibu Sunglasses – Yellow |
id [id] |
12345-Y |
color [colour] |
yellow |
item group id [item_group_id] |
12345 |
| Product | Google Malibu sunglasses |
title [title] |
Google Malibu Sunglasses – Green |
id [id] |
12345-G |
color [colour] |
green |
item group id [item_group_id] |
12345 |
If a single product has multiple colours on it (a pair of shoes that are blue, orange and purple), you can submit up to three colours for a single product. Just specify one primary colour followed by up to two secondary colours that are each separated by a slash (/). For example:
| Product | Classic football boots |
color [colour] |
blue/orange/purple |
| Product | Mid-century couch |
color [colour] |
brown/olive green |
| Product | Skater polka-dot dress |
color [colour] |
black/grey |
You can submit colours for products from a variety of categories, such as electronics.
| Product | Google Nexus 6 |
title [title] |
Google Nexus 6 – 32 GB - Midnight Blue - CDMA - With contract |
id [id] |
2345-32gb-midblu |
color [colour] |
midnight blue |
item group id [item_group_id] |
2345 |
| Product | Google Nexus 6 |
title [title] |
Google Nexus 6 – 32 GB – Cloud White – CDMA – With contract |
id [id] |
2345-32gb-white |
color [colour] |
cloud white |
item group id [item_group_id] |
2345 |
| Product | White Gold Wedding Band |
title [title] |
White Gold Wedding Band – 14 kt – 3 mm |
color [colour] |
white gold |
material [material] |
gold |
| Product | Sterling Silver Celtic Knot Ring with Blue Sapphire |
title [title] |
Sterling Silver Celtic Knot Ring with Blue Sapphire |
color [colour] |
silver/blue |
material [material] |
sterling silver |