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.

When to use

Required for enhanced free listings for all Apparel & Accessories (166) products.

Required for Shopping ads 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>

To format your data for Content API, see the Content API for Shopping.

Guidelines

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

Minimum requirements

These are the requirements 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 in the Diagnostics page in 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 best practices 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

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

Product	Mid-century couch
color	brown/olive green

Product	Skater polka dot dress
color	black/gray

Electronics

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

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