pattern: Definition

Use the pattern attribute to describe the pattern or graphic print on your product. For example, a T-shirt might have a logo of a sports team, and so you might submit bears or tigers. This information helps create accurate filters, which users can use to narrow search results. If your product has variants that vary by pattern, then provide that information through this attribute.

An illustration of a woman wearing a polka dot dress

When to use

Required for all products that vary by pattern

Optional for any products where pattern is an important, distinguishing feature

If the pattern is an important feature of your product, then submit this attribute. For example, a dress might come in polka dot, striped, and paisley. We especially recommend that you submit the pattern attribute if users might search for your product by pattern or if users might decide to buy your product based on the pattern. 

Format

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

Type Unicode characters (Recommended: ASCII only)
Limits 0–100 characters
Repeated field No
 
File format Example entry
Text feeds

Striped

XML feeds <g:pattern>Striped</g:pattern>
Content API v2 (JSON) "pattern": "Striped"
Content API v2 (XML) <pattern>Striped</pattern>

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. 

  • Include the pattern or graphic on your product. Don’t include values that belong in other attributes such as color, size, or material.
  • Submit pattern for all products that vary by pattern. Use this attribute when your product is a variant that’s distinguished by its pattern (e.g., polka dots and stripes), and also submit each variant with the same value for the item_group_id attribute. 

Best practices

These are best practices that can help you go beyond the basic requirements to optimize your product data for performance. 

  • Use a value users will be able to understand. The value you submit can be shown to users, so avoid abbreviations or internal terms. For example, don’t submit plka if you mean polka dots, and don’t submit strpd if you’re referring to a striped shirt. 
  • Don’t use values that don’t mention the pattern. This attribute is optional, so if it isn't relevant for your product, then don’t use it. For example, don’t submit values like n/a, none, multi, or other.

Examples

Variants

If your product has variants of different pattern, submit the pattern for each variant.

Product Women's Skater Dress - Striped
pattern striped
color black/grey
size 8
item_group_id 12345
 
Product Women's Skater Dress - Dotted
pattern dotted
color black/grey
size 8
item_group_id 12345
 
Product Women's Skater Dress - Herringbone
pattern herringbone
color gray
size 8
item_group_id 12345

An illustration of a woman wearing a polka dot dress

Apparel products
Product Bears logo T-shirt
title Men's Bears T-Shirt - Navy Blue - XL
pattern bears
size XL
gender male
color navy blue
 
Product Tigers logo T-shirt
title Women's Tigers T-Shirt - Gray - Large
pattern tigers
size L
gender female
color gray
 
Product Skaters dress
pattern polka dots
color black/white

An illustration of a woman wearing a polka dot dress

Bathroom accessories

Users might use pattern as a deciding factor when shopping for shower curtains, towels, or other bathroom accessories.

Product Striped shower curtain
pattern striped
color green/white
 
Product Floral shower curtain
pattern floral
color purple/green/white
 
Product American flag shower curtain
pattern american flag
color red/blue/white
Furniture

Users might use pattern as a deciding factor when shopping for furniture.

Product Mid-century modern sofa
pattern herringbone
color brown

An illustration of a couch with product staging

Was this article helpful?
How can we improve it?