Attribute Guide
Color Attribute in Google Shopping: Requirements, Format & Best Practices
Everything about the color attribute in Google Merchant Center. When it's required (apparel), how to format single and multi-color values, how it powers…
Zara Floral Print Midi Dress — Navy Blue
Appears in "Navy" filter · Matched to "navy midi dress" · Color swatches shown
Zara Floral Print Midi Dress
Invisible in color filter · Not matched to "navy dress" searches · No swatches · Missing required attribute warning
For apparel, color is a required attribute. Products missing color are excluded from Shopping's color filter — meaning shoppers who refine their search by color never see your product. Color also powers variant swatches shown in some Shopping placements.
What is the color attribute?
The color attribute describes the primary color or colors of a product. For apparel and accessories, it is a required attribute — without it, products are excluded from Google Shopping’s color filter and miss color-specific search queries. For other categories, it’s optional but valuable wherever color is a meaningful differentiator for shoppers.
Color operates at two levels: as a search query matching signal (helping Google surface your product for queries like “navy blue dress” or “red running shoes”) and as a shopping filter and swatch feature that lets shoppers narrow results by color in the Shopping interface. Both functions depend on accurate, standardised color values — not internal codes or creative brand names that can’t be mapped to recognisable colors.
Technical specifications
| Feed name | color |
| Required | Yes — for Apparel & Accessories (google_product_category under "Apparel & Accessories"). Recommended for other categories where color matters. |
| Max length | 40 characters for single color; up to 100 characters for multiple colors separated by slashes |
| Multiple colors | Use slash separator: Red/White/Blue. Maximum 3 colors. Primary color first. |
| Format | Plain text; standard color names in target language. No hex codes, no color numbers. |
| Variants | Each color variant must be a separate product (separate id). Use item_group_id to group variants. |
Where color displays and is used
-
Google Shopping Ads — color filter — When a shopper clicks the “Color” filter in Shopping results, only products with matching color attributes are shown. Products missing color are invisible in these filtered views, losing significant potential impressions from shoppers browsing by color.
-
Google Shopping Ads — variant swatches — For apparel products grouped via
item_group_id, Google sometimes displays color swatches (small color dots) directly in the Shopping ad tile, showing available colors. This increases visibility and click-through by showing variant options before the user even clicks through. -
Free Product Listings (Shopping tab) — The Shopping tab’s color filter works the same way as in paid Shopping Ads. Products without color are excluded from filtered browsing — a significant lost opportunity for organic product discovery.
-
Dynamic Remarketing — Color data is included in the product information used to generate remarketing display ads. Accurate color ensures that remarketing ads show the correct variant the user viewed, improving relevance and conversion rate from remarketed users.
-
Search query matching — Google uses the color attribute (weighted alongside color mentioned in title and description) to match products to color-specific search queries. “Navy blue midi dress” matched via both color attribute and title generates higher-quality impressions than color in title alone.
Rules (what Google enforces)
-
Required for apparel — Missing color on apparel products triggers a “Missing required attribute” warning in Diagnostics. Products may be disapproved or given reduced visibility.
-
No color codes or hex values — Values like “#003366”, “NVY-47”, or “Col-A-012” are not accepted as color descriptions. Use plain text color names.
-
No digits only — The color value cannot be just a number or code without a recognisable color term.
-
Must match the product image — The color attribute must accurately describe the color visible in the product image for that variant. Mismatches are flagged as data quality issues.
-
Maximum 3 colors per product — Only use multiple colors when the product is genuinely multi-colored. Don’t list every shade the product is available in — those are separate variants.
-
Language must match feed language — Color names must be in the target market’s language (e.g., “Blau” in German-language feeds, “Bleu” in French-language feeds).
Best practices
-
Use standard color terms plus brand names — The most effective color format combines a standard base color with a brand or descriptor: “Navy Blue”, “Forest Green”, “Dusty Rose”. The standard base term (“Navy”, “Green”, “Rose”) maps to Shopping’s filter system, while the descriptor adds specificity for text-based query matching.
-
Primary color first in multi-color products — For products with multiple colors (e.g., a striped top), put the dominant color first:
Navy/Whiterather thanWhite/Navyif the product is predominantly navy. Google uses the first color as the primary for filter matching. -
Each color variant needs its own product listing — Never put comma-separated or slash-separated color options for different variants in a single listing. A navy dress and an emerald dress are separate products with separate image links, URLs, and feed rows. Group them with
item_group_id. -
Align color with image — Always verify that the color attribute matches the image shown for that variant. Even a minor mismatch (e.g., “Cobalt Blue” attribute on an image that looks more like indigo) can trigger data quality warnings.
-
Include color in the title as well — For apparel, the title should include color (e.g., “Zara Midi Dress — Navy Blue — Size M”). Color in both the title and the attribute provides dual signal strength for color-specific queries.
-
Standardise color naming across your catalogue — Maintain a canonical color list that maps your internal color codes to standardised feed color names. Apply this consistently via feed rules or your PIM system to prevent inconsistencies.
Impact on performance
-
Color filter exclusion — Without the color attribute, apparel products are entirely invisible when shoppers use the color filter. Depending on category, 20–40% of shopping sessions for clothing include a color filter step. Missing color = missing this entire browsing segment.
-
Color-specific query matching — Searches like “navy blue midi dress”, “emerald green blouse”, or “white sneakers women” require color attribute data to match accurately. These color-specific queries often have higher purchase intent than generic queries and lower competition — excellent ROAS opportunity.
-
Variant swatches CTR uplift — Where Google displays color swatches in Shopping ads (available for grouped variants), products with swatches show 15–25% higher CTR in apparel categories. Swatches are only available when color attributes are correctly submitted for all variants and grouped via item_group_id.
-
Data quality score — Missing required color attribute lowers your feed’s overall data quality score. Low quality score affects impression share across all products in the account, not just those missing color.
-
Reduced disapproval risk — Accurate color attributes eliminate one of the most common apparel-specific disapproval reasons: “mismatched product data” (where image shows one color but color attribute says another).
Common mistakes
-
Using internal color codes (“NVY-03”, “BLKWHT-7”) instead of standard color names
-
Omitting color on apparel products (the most frequent missing required attribute in apparel feeds)
-
Listing all available colors for a product in a single listing instead of submitting separate variants
-
Color attribute not matching the image (e.g., color = “Red” but image shows orange-red — will flag)
-
Using English color names in non-English feeds (must match target market language)
-
Including color codes or hex values alongside the name (e.g., “Navy #003366”) — remove the code, use only the name
-
Overly creative color names with no standard base term (“Midnight Whisper”, “Sunlit Reverie”) — filter-matching impossible
Pro tips
-
Build a color normalisation layer in your feed pipeline — Map all internal color codes, supplier color names, and product database color values to standardised feed-ready color names. This is a one-time investment that eliminates ongoing color data quality issues across your entire catalogue. Implement it as a lookup table in your ETL pipeline or Merchant Center feed rules.
-
Use item_group_id to unlock swatch display — Color swatches in Shopping ads appear only when: (a) all color variants are submitted as separate products, (b) all share the same
item_group_id, and (c) each has its correctcolorandimage_link. Getting all three right unlocks swatches automatically — no additional setup required. -
Mine the color filter performance in Search Terms data — In Google Ads, filter search terms by color-related keywords (“navy”, “emerald”, “white”, “black”). If specific colors consistently outperform others in conversion rate, use those insights to prioritise inventory, ad spend, and image quality for those color variants.
-
For seasonal colour trends: update color names with supplemental feeds — If Pantone’s Color of the Year or a seasonal trend creates demand for a specific color name (e.g., “Peach Fuzz” 2024), you can add these trending descriptors to existing color attributes via a supplemental feed without touching your main feed or PIM system. Time this to coincide with peak search volume for the trend.
Frequently asked questions
Is the color attribute required for all products?
What color values should I use — specific or general?
How do I format a product with multiple colors?
Red/White/Blue. The primary (dominant) color should be first. Maximum 3 colors per product. The entire string must be under 100 characters. Each color in the combination counts towards search matching and filter eligibility — if a shopper filters by "Blue", a product with "Red/White/Blue" will appear.Can I use my brand's proprietary color names?
Midnight Navy — the recognisable base color term ("Navy") ensures filter matching even if shoppers don't know your brand's proprietary names. A value like "Aqua Bliss 47" with no standard color term won't map to Shopping's color filters.Does color affect which Shopping searches my product appears for?
Do I need separate products for each color variant?
id, color, image_link (showing that color), and optionally grouped via item_group_id. Submitting all colors as a single product with comma-separated colors is not correct — each variant needs its own row so Google can show the right image and link for each color option.What happens if the color in my feed doesn't match the image?
image_link for that variant.