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 |
|
XML feeds | <g:color>Orange Mango Explosion</g:color> |
To format your data for Content API, see the Content API for Shopping.
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 theitem_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 tocolor
to indicate a precious metal. If your product is made of a precious metal, like a gold ring, submit this information with thematerial
andcolor
attributes. - Include standard color names in your title. For the
color
attribute, submit the color that matches your landing page. Then for yourtitle
, 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
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
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 |
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 |
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 |
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 |