color: Definition

Use the color attribute to describe your product’s color. This information helps create accurate filters, which users can use to narrow search results. If your product has variants that vary by color, 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 color

Required for Apparel & 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 we understand the data you're submitting. 

Type String (Alphanumeric, Unicode characters. Recommended: ASCII
Limits 1–100 characters total (1–40 characters per color)
Repeated field No
Schema.org property (What’s this?) Product.color, Type: Text
 
File format Example entry
Text feeds

Orange Mango Explosion

XML feeds <g:color>Orange Mango Explosion</g:color>
Content API v2 (JSON) "color": "Orange Mango Explosion"
Content API v2 (XML) <color>Orange Mango Explosion</color>

Guidelines

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

Minimum requirements

These are the requirements 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 in the Diagnostics page of your Merchant Center account. 

  • Submit the color of your product.  
  • Submit only one attribute per item. If you provide multiple color attributes for the same item, only one will be applied. Additional color attributes will be discarded, and you will receive a warning.
  • Use the same color 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 for all products that vary by color. Use this attribute when your product is a variant that’s distinguished by its color (e.g., black suede shoes and blue suede shoes), and also submit each variant with the same value for the item_group_id attribute.
  • Include up to 3 colors. If your product is made up of several colors, you can specify 1 primary color followed by up to 2 secondary colors that are each separated by a slash ( / ). For example: Red/Green/Black. Don’t submit multiple colors with a comma ( , ). For example, for a red shoe with green and black accents list: Red/Green/Black. Don’t combine colors together (RedGreenBlack). Don’t submit multiple colors with a comma (Red, Green, Black). If you use commas when entering colors, only one color will be applied.
  • Don’t use a number as a color 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 references the product or image such as see image.
  • Don’t include a value that isn’t a color such as variety, mens, womens, N/A.

Best practices

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

  • Submit a material value in addition to color to indicate a precious metal. If your product is made of a precious metal, like a gold ring, submit this information with the material and color attributes.
  • Include standard color names in your title. For the color attribute, submit the color that matches your landing page. Then for your title, pick the standard color 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 color names

If you describe your product on your landing page using a unique color, like Pop Girl or High Five, submit that value through the color attribute. Then add a more standard color name, like Red or Black, to your title.

Product Running shoes
title Running shoes - Orange - 6.5
size 6.5
color mango explosion

An illustration of a woman wearing a black dress

Product Skater dress
title Black Skater dress
size 10
color nightfall

Standard color examples include: blue, orange, yellow, gray, red, green, black, and white

Unique colors examples include: light salmon, dark tangerine, desert sand, and lavender blush

Variants

If your product comes in multiple color 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 attribute.

Product Google Malibu sunglasses
title Google Malibu Sunglasses - Red
id 12345-R
color red
item group id 12345

 

Product Google Malibu sunglasses
title Google Malibu Sunglasses - Blue
id 12345-B
color blue
item group id 12345

 

Product Google Malibu sunglasses
title Google Malibu Sunglasses - Yellow
id 12345-Y
color yellow
item group id 12345

 

Product Google Malibu sunglasses
title Google Malibu Sunglasses - Green
id 12345-G
color green
item group id 12345
Product that has multiple colors

If a single product has multiple colors on it (a pair of shoes that is blue, orange, and purple), you can submit up to 3 colors for a single product. Just specify 1 primary color followed by up to 2 secondary colors that are each separated by a slash ( / ). For example:

Product Classic soccer shoes
color blue/orange/purple

An illustration of a shoe

Product Mid-century couch
color brown/olive green

An illustration of a couch with product staging

Product Skater polka dot dress
color black/gray

An illustration of a woman wearing a polka dot dress

Electronics

You can submit colors 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 Google Nexus 6 - 32 GB - Midnight Blue - CDMA - With contract
id 2345-32gb-midblu
color midnight blue
item group id 2345

 

Product Google Nexus 6
title Google Nexus 6 - 32 GB - Cloud White - CDMA - With contract
id 2345-32gb-white
color cloud white
item group id 2345
Jewelry
Product White Gold Wedding Band
title White Gold Wedding Band - 14K - 3mm
color white gold
material gold
Product Sterling Silver Celtic Knot Ring with Blue Sapphire
title Sterling Silver Celtic Knot Ring with Blue Sapphire
color silver / blue
material sterling silver
Was this article helpful?
How can we improve it?