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.
In this article
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?) |
|
File format | Example entry |
---|---|
Text feeds |
|
XML feeds | <g:color>Orange Mango Explosion</g:color> |
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 namesIf 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 |
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
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 |
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 |
For mid century couch |
|
Attribute | Value |
Color [color] |
light green/olive green |
For a multi-hued t-shirt | |
Attribute | Value |
Color [color] |
blue/dark blue/light blue |
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 |
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 |