color [color]

Use the color [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 all products in an item group that vary by color.

Required for all apparel items. Recommended for all products for which color is an important, distinguishing attribute.

Format

Follow these formatting guidelines to make sure we understand the data you're submitting.

Type String (Unicode characters. Recommended: ASCII only)
Limits Up to 1000 characters total (1–40 characters per color)
Repeated field No

 

File format Example value
Text feeds Orange Mango Explosion
XML feeds <g:color>Orange Mango Explosion</g:color>

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 upload data for your products. If you don't follow these requirements, we'll disapprove this attribute and let you know in the Diagnostics page of your Manufacturer Center account.

  • Submit the color of your product.  
  • 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 [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 [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 ( , ). 
  • 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.
  • 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 [material] value in addition to color [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 [material] and color [color] attributes.
  • You may use standard color names in your product title. For the color [color] attribute, submit the color that matches your landing page. If you'd like to keep the generic color value, use the title [title] for placing the generic value. For example, a user is more likely to search for red dress than cinnamon apple dress.
  • Use consistent names of colors across variants of the same product, as well as across multiple products of the same category, for example if you sell a handbag in 3 colors, red, pink, and blue submit red, pink, and blue and not red, pink, and see product for details.

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

Attribute Value
title [title] Google Running shoes - Orange - 6.5
size [size] 6.5
color [color] Mango Explosion

Attribute Value
title [title] Google Black Skater dress
size [size] 10
color [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 [item_group_id] attribute.
Attribute Value
title [title] Google Malibu Sunglasses - Red
id [id]

12345-R

color [color] Red
item group id [item_group_id] 12345
 
Attribute Value
title [title] Google Malibu Sunglasses - Blue
id [id]

12345-B

color [color] Blue
item group id [item_group_id] 12345
 
Attribute Value
title [title] Google Malibu Sunglasses - Yellow
id [id]

12345-Y

color [color] Yellow
item group id [item_group_id] 12345
 
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:

Attribute Value
color [color]

Blue/Orange/Purple

 

Attribute Value
color [color]

Brown/Olive Green

 

Attribute Value
color [color]

Black/Gray

Electronics

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

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

 

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

Attribute Value
title [title] Google White Gold Wedding Band - 14K - 3mm
color [color] White Gold
material [material] Gold

 

Attribute Value
title [title] Google Sterling Silver Celtic Knot Ring with Blue Sapphire
color [color] Silver / Blue
material [material] Sterling Silver
Was this helpful?
How can we improve it?