color: Definition

When to use

Required for all products that vary by color

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

Guidelines

Follow these guidelines to make sure you submit high-quality data for your products and get the best performance from your ads.

Minimum requirements

These are the requirements you'll need to meet to show ads for your product. If you don't follow these requirements, we'll disapprove your product and let you know in the Diagnostics page of 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 are best practices that 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