color [colour]: Definition

Use the color [colour] attribute to describe your product's colour. This information helps create accurate filters, which users can use to narrow search results. If your product has variants that vary by colour, then provide that information through this attribute.

An illustration of a person shopping online and filtering clothing options by color

When to use

Required for all products that vary by colour

Required for Clothing & Accessories (166) products when targeting these countries:

  • Brazil
  • France
  • Germany
  • Japan
  • The United Kingdom
  • The United States 

Format

Follow these formatting guidelines to make sure that we understand 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

Orange Mango Explosion

XML feeds <g:color>Orange Mango Explosion</g:color>

For format API information, please see Content API for Shopping.

Guidelines

Follow these guidelines to make sure that you submit high-quality data for your products and get the best performance from your ads.

Minimum requirements

These are the requirements that you'll need to meet to show ads for 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 item. If you provide multiple colour attributes for the same item, 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 color [colour] for all products that vary by colour. Use this attribute when your product is a variant that's distinguished by its colour (e.g., black suede shoes and blue suede shoes), and also submit each variant with the same value for the item_group_id [item_group_id] attribute.
  • Include up to three colours. If your product is made up of several colours, you can specify one primary colour followed by up to two 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 (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 one 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, men's, women's, N/A.

Best practices

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

  • Submit a material [material] value in addition to color [colour] to indicate a precious metal. If your product is made of a precious metal, like a gold ring, submit this information with the material [material] and color [colour] attributes.
  • Include standard colour names in your title. For the color [colour] attribute, submit the colour that matches your landing page. Then for your title [title], pick the standard colour name that a user would search for. For example, a user is more likely to search for red dress than cinnamon apple dress.

Examples

Unique colour names

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

An illustration of a woman wearing a black dress

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

Variants

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
Product that has multiple colours

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

An illustration of a shoe

Product Mid-century couch
color [colour] brown/olive green

An illustration of a couch with product staging

Product Skater polka-dot dress
color [colour] black/grey

An illustration of a woman wearing a polka dot dress

Electronics

You can submit colours for products from a variety of categories, such as electronics.

An illustration with 3 different colors of one mobile phone

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
Jewellery
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
Was this helpful?
How can we improve it?

Need more help?

Sign in for additional support options to quickly solve your issue