Color [color]

A custom icon for Merchant Center Classic and Merchant Center Next.

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

An illustration of filtering clothing options by color

When to use

Required for free listings for all Apparel Accessories (ID:166) products.

Required for Shopping ads for Apparel Accessories (ID:166) products when targeting these countries:

Brazil
France
Germany
Japan
United Kingdom
United States

Format

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

Learn when and how to submit your product data in English

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 feature.

Note: To ensure that this product data attribute gets recognized by our system correctly, remember to submit your data feed file in a format that we support.

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 your Merchant Center account.

Submit the color of your product.
Submit only one attribute per variant. If you provide multiple color attributes for the same variant, 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 the color attribute for all products that vary by color. Use this attribute when your product is a variant that’s distinguished by its color (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 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 reference 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.

To indicate a precious metal, submit a value for the material attribute as well as a value for the color [color] attribute. If your product is made of a precious metal, like a gold ring, submit this information with the material [material] and color attributes.
Include standard color names in your title. When you submit a value for the color attribute, submit the color that matches the one on the landing page for that product. When submitting a value for the title [title] attribute, pick the standard color name that a customer would search for. For example, a customer 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 [color] attribute. Then add a more standard color name, like "Red" or "Black", to your title [title].

Product data for orange running shoes, size 6.5
Attribute	Value
Title `[title]`	Running shoes - Orange - 6.5
Size `[size]`	6.5
Color `[color]`	mango explosion

An illustration of a woman wearing a black dress

Product data for black skater dress
Attribute	Value
Title `[title]`	Black Skater dress
Size `[size]`	10
Color `[color]`	nightfall

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

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

Variants

If your product comes in multiple color variants (for example, “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 data for red Malibu sunglasses
Attribute	Value
Title `[title]`	Google Malibu Sunglasses - Red
ID `[id]`	12345-R
Color `[color]`	red
Item group ID `[item group id]`	12345

Product data for blue Malibu sunglasses
Attribute	Value
Title `[title]`	Google Malibu Sunglasses - Blue
ID `[id]`	12345-B
Color `[color]`	blue
Item group ID `[item group id]`	12345

Product data for yellow Malibu sunglasses
Attribute	Value
Title `[title]`	Google Malibu Sunglasses - Yellow
ID `[id]`	12345-Y
Color `[color]`	yellow
Item group ID `[item group id]`	12345

Product data for green Malibu sunglasses
Attribute	Value
Title `[title]`	Google Malibu Sunglasses - Green
ID `[id]`	12345-G
Color `[color]`	green
Item group ID `[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:

For a classic tennis shoe
Attribute	Value
Color `[color]`	red/gray/white

An illustration of a shoe

For mid century couch
Attribute	Value
Color `[color]`	light green/olive green

An illustration of a couch with product staging

For a multi-hued t-shirt
Attribute	Value
Color `[color]`	blue/dark blue/light blue

An illustration of clicking different pattern options.

Electronics

An illustration with 3 different colors of one mobile phone

Product data for a blue Google Nexus 6
Attribute	Value
Title `[title]`	Google Nexus 6 - 32 GB - Midnight Blue - CDMA - With contract
ID`[id]`	2345-32gb-midblu
Color `[color]`	midnight blue
Item group ID`[item group id]`	2345

Product data for a white Google Nexus 6
Attribute	Value
Title `[title]`	Google Nexus 6 - 32 GB - Cloud White - CDMA - With contract
ID `[id]`	2345-32gb-white
Color `[color]`	cloud white
Item group ID `[item group id]`	2345

Jewelry

Product data for a white gold wedding band
Attribute	Value
Title `[title]`	White Gold Wedding Band - 14 K - 3 mm
Color `[color]`	white gold
Material `[material]`	gold

Product data for a sterling silver ring with blue sapphire
Attribute	Value
Title `[title]`	Sterling Silver Celtic Knot Ring with Blue Sapphire
Color `[color]`	silver/blue
Material `[material]`	sterling silver

Was this helpful?

How can we improve it?