pattern [pattern]: Definition

Use the pattern [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 material, 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 [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 that we understand the data that 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>

For format API information, please see Content API for Shopping.

Guidelines

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

Minimum requirements

These are the requirements that 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 on 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 colour, size or material.
  • Submit pattern [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 [item_group_id] attribute. 

Best practices

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

  • Use a value that users will be able to understand. The value that 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's not 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 patterns, submit the pattern for each variant.

Product Women's skater dress – Striped
pattern [pattern] striped
color [colour] black/grey
size [size] 8
item_group_id [item_group_id] 12345
 
Product Women's skater dress – Dotted
pattern [pattern] dotted
color [colour] black/grey
size [size] 8
item_group_id [item_group_id] 12345
 
Product Women's skater dress – Herringbone
pattern [pattern] herringbone
color [colour] grey
size [size] 8
item_group_id [item_group_id] 12345

An illustration of a woman wearing a polka dot dress

Clothing products
Product Bears logo T-shirt
title [title] Men's Bears T-shirt – Navy blue – XL
pattern [pattern] bears
size [size] XL
gender [gender] male
color [colour] navy blue
 
Product Tigers logo T-shirt
title [title] Women's Tigers T-shirt – Grey – Large
pattern [pattern] tigers
size [size] L
gender [gender] female
color [colour] grey
 
Product Skater dress
pattern [pattern] polka dots
color [colour] black/white

An illustration of a woman wearing a polka dot dress

Bathroom accessories

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

Product Striped shower curtain
pattern [pattern] striped
color [colour] green/white
 
Product Floral shower curtain
pattern [pattern] floral
color [colour] purple/green/white
 
Product Union Jack shower curtain
pattern [pattern] Union Jack
color [colour] red/blue/white
Furniture

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

Product Mid-century modern sofa
pattern [pattern] herringbone
color [colour] grey

An illustration of a couch with product staging

Was this helpful?
How can we improve it?

Need more help?

Sign in for additional support options to quickly solve your issue