Product information specification

Use this specification to format your product data for Merchant Eye programs, such as Shopping ads, complimentary product listings, and Buy on Google. Submitting your production information to Google in the correct format is important for creating successful ads and free listings for your products. Google uses this data to brand sure that it'southward matched to the correct queries.

Before you begin

If y'all're new to Merchant Center, get started with the onboarding guide.

Other requirements to proceed in mind

Additional production information specifications

Definitions

  • Product. Word that describes the bodily product that your potential customers would exist searching for on Google.
  • Detail. Word that describes a product once it's been added to your product data, either in a text feed, XML feed, or API. For example, an item is 1 line in your text feed.
  • Variant. Word that describes a product that comes in unlike variations. For example, a shirt that comes in unlike sizes has size variants.

Quick reference

Click the name of an attribute to view full details, including more information about the minimum requirements, all-time practices, and examples.

Bones product data

The product information y'all submit using these attributes is our foundation for creating successful ads and complimentary listings for your products. Make sure everything yous submit is of the quality you lot'd show to a customer.

Attribute Format Minimum requirements at a glance
ID [id]

Required

Your production'southward unique identifier

Case
A2B4

Syntax
Max fifty characters

Schema.org property
Product.sku

  • Utilise a unique value for each product. Apply the product's SKU where possible. The ID value does non need to be a product identifier, like an MPN, though it tin be if your SKU for the production matches the MPN.
  • Keep the ID the same when updating your data
  • Apply just valid unicode characters. Avoid invalid characters like command, function, or private area characters
  • Use the same ID for the same product - beyond countries or languages
Championship [championship]

Required

Your product's name

Example
Mens Pique Polo Shirt

Syntax
Max 150 characters

Schema.org property
Product.name

  • Accurately describe your product and match the title from your landing page
  • Don't include promotional text like "free shipping," all upper-case letter letters, or gimmicky foreign characters
  • For variants
    • Include a distinguishing characteristic such every bit colour or size
  • For mobile devices
    • Include "with contract" if sold with a contract
    • For the United States, include "with payment plan" if sold in installments
  • For Russia
    • For books and other information products, include the age rating at the offset of the title
Clarification [description]

Required

Your production's clarification

Example
Fabricated from 100% organic cotton, this classic ruby-red men's polo has a slim fit and signature logo embroidered on the left chest. Machine wash cold; imported.

Syntax
Max 5000 characters

Schema.org property
Product.description

  • Accurately draw your production and match the description from your landing page
  • Don't include promotional text like "complimentary aircraft," all majuscule letters, or gimmicky foreign characters
  • Include just information virtually the product. Don't include links to your store, sales information, details most competitors, other products, or accessories
  • Use formatting (for example, line breaks, lists, or italics) to format your clarification
Link [link]

Required

Your product's landing folio

Example
http://​www.case.​com/​asp​/sp.asp?cat=​12&id=1030

Schema.org holding
Offer.​url

  • Utilize your verified domain proper name
  • Offset with http or https
  • Apply an encoded URL that complies with RFC 2396 or RFC 1738. For case, a comma would exist represented as "%2C"
  • Don't link to an interstitial page unless legally required
Image link [image_link]

Required

The URL of your production'south principal image

Instance
http:// www.example.com/image1.jpg

Schema.org property
Product.image

  • For the image URL:
    • Link to the main image of your product
    • Get-go with http or https
    • Utilise an encoded URL that complies with RFC 2396 or RFC 1738. For example, a comma would exist represented as "%2C"
    • Make sure the URL tin can be crawled by Google (robots.txt configuration assuasive Googlebot and Googlebot-image)
  • For the image:
    • Accurately display the production y'all're selling
    • Utilize an accustomed format: JPEG (.jpg/.jpeg), WebP (.webp), PNG (.png), non-blithe GIF (.gif), BMP (.bmp), and TIFF (.tif/.tiff)
    • For not-apparel products, use an prototype of at to the lowest degree 100 10 100 pixels
    • For apparel products, utilize an image of at to the lowest degree 250 x 250 pixels
    • Don't submit an prototype larger than 64 megapixels or a file larger than 16MB
    • Don't scale up an image or submit a thumbnail
    • Don't include promotional text, watermarks, or borders
    • Don't submit a placeholder or a generic image Exceptions:
      • In Hardware (632) or Vehicles & Parts (888) categories, illustrations are accepted.
      • In any paint category, single color images are immune
Additional paradigm link [additional_image_link]

Optional

The URL of an additional image for your product

Instance
http://www.example.com/image1.jpg

Syntax
Max 2000 characters

  • Meet the requirements for the image link [image_​link] attribute with these exceptions:
    • The image can include production staging and testify the product in utilise
    • Graphics or illustrations tin can be included
  • Submit up to ten additional production images by including this attribute multiple times
Mobile link [mobile_link]

Optional

Your production's mobile-optimized landing folio when you have a different URL for mobile and desktop traffic

Case
http://world wide web.m.example.com/asp/ sp.asp?true cat=12 id=1030

Syntax
Max 2000 alphanumeric characters

  • Encounter the requirements for the link [link] attribute

Toll & availability

These attributes ascertain the price and availability for your products. This information is shown to potential customers in your ads and free listings. If your products' prices and availability alter oftentimes, keep in mind that you'll demand to let Google know about all the updates to be able to testify your products. Check out these tips for keeping your product information fresh.

Aspect Format Minimum requirements at a glance

Availability
[availability]

Required

Your product's availability

Example
in_stock

Supported values

  • In stock [in_stock]
  • Out of stock [out_of_stock]
  • Preorder [preorder]
  • Backorder [backorder]

Schema.org property
Offering.availability

  • Accurately submit the product'due south availability and friction match the availability from your landing folio and checkout pages.
  • Provide the availability date [availability_date] aspect (with a value up to 1 twelvemonth in the hereafter) if the availability is ready to preorder or backorder
Availability appointment
[availability_date]

Required if production availability is set to preorder or backorder

The appointment a preordered or backordered product becomes bachelor for delivery

Example
(For UTC+1)
2016-02-24T11:07+0100

Syntax

  • Max 25 alphanumeric characters
  • ISO 8601
    • YYYY-MM-DDThh:mm [+hhmm]
    • YYYY-MM-DDThh:mmZ

Schema.org property
Offer.availabilityStarts

  • Utilise this aspect if your product'due south availability is set to preorder or backorder. Provide a value up to i year in the futurity.
  • The availability date should besides be added to the product's landing page and exist clear to your customers (for example, "May 6, 2023"). If an exact date can't be provided, you tin utilise an estimated date (for case, "May 2023").
Cost of appurtenances sold
[cost_of_goods_sold]

Optional

The costs associated with the sale of a particular product as defined by the accounting convention you set. These costs may include material, labor, freight, or other overhead expenses. By submitting the COGS for your products, yous gain insights nigh other metrics, such as your gross margin and the amount of revenue generated by your ads and free listings.

Instance
23.00 USD

Syntax

  • ISO 4217 codes
  • Apply '.' rather than ',' to signal a decimal point
  • Numeric
Expiration date
[expiration_date]

Optional

The date that your product should cease showing

Example
(For UTC+ane)
2016-07-11T11:07+0100

Syntax

  • Max 25 alphanumeric characters
  • ISO 8601
    • YYYY-MM-DDThh:mm [+hhmm]
    • YYYY-MM-DDThh:mmZ
  • Use a date less than 30 days in the future
Price [price]

Required

Your product's toll

Example
15.00 USD

Syntax

  • Numeric
  • ISO 4217

Schema.org property
Offer.​​priceSpecification

  • Accurately submit the product's price and currency, and match with the price from your landing page and at checkout
  • Make sure that your landing page and the checkout pages include the cost in the currency of the country of sale prominently and in a place that's straightforward to find
  • Ensure that the production can be purchased online for the submitted price
  • Brand sure that whatever customer in the country of sale tin buy the product for the submitted price, and without paying for a membership
    • Add any minimum order value in your shipping settings
  • Don't submit a price of 0 (a price of 0 is immune for mobile devices sold with a contract)
  • For products sold in bulk quantities, bundles, or multipacks
    • Submit the total cost of the minimum purchasable quantity, parcel, or multipack
  • For the U.s. and Canada
    • Don't include tax in the price
  • For all other countries
    • Include value added tax (VAT) or Goods and Services Tax (GST) in the price
  • For boosted options to submit toll-related information, see the following attributes:
    • Unit pricing measure [unit_pricing_measure]
    • Unit of measurement pricing base measure [unit_pricing_base_measure]
    • Sale price [sale_price]
    • Subscription price [subscription_cost]
    • Installment [installment]
Sale price
[sale_price]

Optional

Your production's sale price

Example
15.00 USD

Syntax

  • Numeric
  • ISO 4217
  • See the requirements for the toll [price] aspect
  • Submit this attribute (sale cost )in addition to the price [price] attribute set to the not-sale toll
  • Accurately submit the product'southward auction price, and friction match the sale cost with your landing page and the checkout pages
Auction price effective date [sale_price_effective_date]

Optional

The engagement range during which the auction price applies

Example
(For UTC+one)
2016-02-24T11:07+0100 /
2016-02-29T23:07+0100

Syntax

  • Max 51 alphanumeric characters
  • ISO 8601
    • YYYY-MM-DDThh:mm [+hhmm]
    • YYYY-MM-DDThh:mmZ
  • Carve up kickoff date and end date with /
  • Use together with the sale price [sale_price] attribute
  • If you don't submit this attribute (sale price effective date), the sale price always applies
  • Use a start date earlier the end date
Unit pricing measure out
[unit_pricing_measure]

Optional (except when required by local laws or regulations)

The measure and dimension of your product equally it is sold

Example
1.5kg

Syntax
Numerical value + unit

Supported units

  • Weight: oz, lb, mg, chiliad, kg
  • Volume United states imperial: floz, pt, qt, gal
  • Volume metric: ml, cl, fifty, cbm
  • Length: in, ft, yd, cm, g
  • Expanse: sqft, sqm
  • Per unit: ct
  • Use the measure or dimension of the production without packaging
  • Use a positive number
  • For variants
    • Include the same value for detail group ID [item_group_id] and dissimilar values for unit pricing measure

Unit pricing base of operations measure out [unit_pricing_base_measure]

Optional (except when required by local laws or regulations)

The product's base measure for pricing (for example, 100ml ways the price is calculated based on a 100ml units)

Instance
100g

Syntax
Integer + unit

Supported integers
i, 10, 100, two, four, 8

Supported units

  • Weight: oz, lb, mg, m, kg
  • Volume United states imperial: floz, pt, qt, gal
  • Volume metric: ml, cl, fifty, cbm
  • Length: in, ft, yd, cm, one thousand
  • Expanse: sqft, sqm
  • Per unit of measurement: ct

Additional supported metric integer + unit combinations
75cl, 750ml, 50kg, 1000kg

  • Optional when you submit the unit pricing measure out [unit_pricing_measure] attribute
  • Use the aforementioned unit of measure for this attribute (unit pricing measure) and unit pricing base measure
  • Proceed in mind that the price (or sale price, if active) is used to calculate the unit of measurement cost of the product. For example, if the toll [price] aspect is set to 3 USD , unit pricing measure out is 150ml, and unit of measurement pricing base of operations measure is set up to 100ml, and so the unit price is 2 USD / 100ml
Installment
[installment]

Optional (A vailable in Latin America for all production categories and in sure other countries for showing wireless products and services only)

Details of an installment payment plan

Case
6,50 BRL

SyntaxThis attribute uses 2 sub-attributes:

  • Months [months] (Required)
    Integer, the number of installments the buyer has to pay.
  • Amount [corporeality] (Required)
    ISO 4217, the amount the heir-apparent has to pay per month
  • Friction match the installment option that's visible on your landing page
  • Don't require a loyalty card
  • For Latin America, make sure the cost [toll] attribute is the total price when paid in full up-front and utilize the installment [installment] attribute to indicate an alternative payment option using installments.
  • For other countries, use the toll attribute (equally low as 0) as the upwardly-front payment (including any device down payment and activation fees), and the installment attribute for boosted monthly installment payments.
Subscription toll
[subscription_cost]

Optional (Available in certain countries for showing wireless products and services only)

Details a monthly or annual payment programme that bundles a communications service contract with a wireless product

Example
calendar month:12:35.00USD

Syntax
This aspect uses 3 sub-attributes:

  • Flow [period] (Required)
    The duration of a unmarried subscription menstruation. This sub-aspect uses the following supported values:
    • Month [month]
    • Yr [twelvemonth]
  • Period length [period_length] (Required)
    Integer, the number of subscription periods (months or years) that the buyer must pay.

  • Corporeality [amount] (Required)
  • ISO 4217, the amount the buyer must pay per month. When displaying this amount, Google may round up to the nearest whole unit of local currency to salvage space. The provided value must still exactly match the amount as shown on your site.
  • Submit the cost [price] attribute with the total corporeality due at checkout (including down payment and activation fee).

  • Match the communications payment plan that you display on your landing page. The plan must be easy to find on the landing page.

Loyalty points
[loyalty_points]

Optional (Available for Japan only)

The number and type of loyalty points a client receives when buying a product

Example
Programme A, 100, 1.5

Syntax
This aspect uses 3 sub-attributes:

  • Loyalty point value [points_​value] (Required)
    Number of points earned for the product
  • Loyalty points program name [name] (Optional)
    Name of the loyalty points program, 12 full-width characters or 24 roman characters
  • Ratio [ratio] (Optional)
    Number, the ratio of a betoken when converted to currency
  • Merely submit loyalty points with a specific monetary value

Product category

Yous can use these attributes to organize your advertizing campaigns in Google Ads and to override Google's automatic product categorization in specific cases.

Attribute Format Minimum requirements at a glance
Google production category [google_product_category]

Optional

Google-defined product category for your product

Example
Apparel & Accessories > Clothing > Outerwear > Coats & Jackets

or

371

Syntax
Value from the Google product taxonomy

  • The numerical category ID, or
  • The full path of the category

Supported values
Google production taxonomy

  • Include only i category
  • Include the most relevant category
  • Include either the total path of the category or the numerical category ID, but not both. It is recommended to employ the category ID.
  • Include a specific category for certain products:
    • Alcoholic beverages must be submitted with i of these categories:
      • Food, Beverages & Tobacco > Beverages > Alcoholic Beverages (ID: 499676), or any of its subcategories
      • Arts & Entertainment > Hobbies & Creative Arts > Homebrewing & Winemaking Supplies (ID: 577), or any of its subcategories
    • Mobile devices sold with contract must be submitted as Electronics > Communications > Telephony > Mobile Phones (ID: 267) for phones or Electronics > Computers > Tablet Computers (ID: 4745) for tablets
    • Gift Cards must be submitted as Arts & Entertainment > Party & Celebration > Gift Giving > Gift Cards & Certificates (ID:53)
Product type [product_type]

Optional

Product category that you define for your product

Example
Home > Women > Dresses > Maxi Dresses

Syntax

Max 750 alphanumeric character

  • Include the full category. For example, include Home > Women > Dresses > Maxi Dresses instead of just Dresses
  • Only the first product type value will be used to organize bidding and reporting in Google Ads Shopping campaigns

Product identifiers

These attributes are used to provide product identifiers that ascertain the products you're selling in the global marketplace. Google uses production identifiers to understand what you're selling. When nosotros understand what y'all're selling, we can help heave the operation of your ads and complimentary listings by adding valuable details nigh the product and serving it in a more relevant manner to customers. Learn more than nigh production identifiers.

Attribute Format Minimum requirements at a glance
Brand [brand]

Required (For all new products, except movies, books, and musical recording brands)

Optional for all other products

Your product's make name

Case
Google


Syntax
Max lxx characters


Schema.org property
Production.brand

  • Provide the brand name of the product by and large recognized by consumers
  • Providing the correct make for a product volition ensure the best user experience and result in the best performance.
  • Merely provide your own brand name as the make if you manufacture the production or if your product falls into a generic brand category. For instance, you could submit your own make name equally the brand if you lot sell private-label products or customized jewelry.
  • For products that truly do not take a brand (for case, a vintage wearing apparel without a characterization, generic electronics accessories, etc.) go out this field empty.
  • Don't submit values such every bit "Northward/A", "Generic", "No brand", or "Does not be".
  • For compatible products:
    • Submit the GTIN and brand from the manufacturer who actually built the compatible product
    • Don't provide the Original Equipment Manufacturer (OEM) brand to signal that your production is compatible with or a replica of the OEM brand'due south product
GTIN [gtin]

Required (For all products with a known GTIN to enable full offer performance)

Optional (strongly recommended) for all other products

Your product's Global Trade Item Number (GTIN)

Example
3234567890126

Syntax
Max fifty numeric characters (max 14 per value - added spaces and dashes are ignored)

Supported values

  • UPC (in Northward America / GTIN-12)
    12-digit number like 323456789012
    viii-digit UPC-E codes should exist converted to 12-digit codes
  • EAN (in Europe / GTIN-13)
    13-digit number like 3001234567892
  • JAN (in Japan / GTIN-13)
    8 or xiii-digit number similar 49123456 or 4901234567894
  • ISBN (for books)
    10 or xiii-digit number like 1455582344 or 978-1455582341. If you have both, only include the 13-digit number. ISBN-10 are deprecated and should be converted to ISBN-xiii
  • ITF-14 (for multipacks / GTIN-14)
    14-digit number like 10856435001702

Schema.org belongings
Production.isbn
Product.gtin8
Product.gtin12
Production.gtin13
Production.gtin14

  • Exclude dashes and spaces
  • Submit just valid GTINs as defined in the official GS1 validation guide, which includes these requirements:
    • The checksum digit is nowadays and correct
    • The GTIN is non restricted (GS1 prefix ranges 02, 04, 2)
    • The GTIN is not a coupon (GS1 prefix ranges 98 - 99)
  • Providing the correct GTIN for a production will ensure the best user experience and consequence in the best functioning.
  • Only provide a GTIN if you're sure it is correct. When in doubt don't provide this attribute (for example, do not approximate or make up a value). If you submit a product with an wrong GTIN value, your product will be disapproved.
  • For compatible products:
    • Submit the GTIN and brand from the manufacturer who actually built the compatible product
    • Don't provide the Original Equipment Manufacturer (OEM) brand to indicate that your production is uniform with or a replica of the OEM make's product
  • For multipacks:
    • Utilize the product identifiers that relates to the multipack
  • For bundles:
    • Use the product identifiers for the main product in the bundle
  • If yous offer customization, engraving, or other personalization of a product that'south been assigned a GTIN by the manufacturer:
    • Submit the GTIN and employ the parcel [is_​bundle] attribute to allow Google know that the production includes customization
MPN [mpn]

Required (Only if your production does not take a manufacturer assigned GTIN)

Optional for all other products

Your product'southward Manufacturer Part Number (mpn)

Example
GO12345OOGLE

Syntax
Max 70 alphanumeric characters

Schema.org property
Product.mpn

  • Only submit MPNs assigned by a manufacturer
  • Utilize the most specific MPN possible. For example, different colors of a product should take different MPNs.
  • Providing the correct MPN for a product (when required) will ensure the all-time user experience and result in the all-time performance.
  • Only provide an MPN if y'all're sure it's correct. When in doubtfulness don't provide this attribute (for case, don't guess or brand up a value).
  • If you submit a product with an incorrect MPN value, your product will be disapproved.
Identifier exists [identifier_exists]

Optional

Apply to betoken whether or not the unique product identifiers (UPIs) GTIN, MPN, and brand are available for your production.

Example
no

Supported values

  • Aye [yes]
    Product identifiers are assigned to the new product by the manufacturer
  • No [no]
    Product lacks a brand, GTIN, or MPN (encounter requirements to the right). If fix to no, nonetheless provide the UPIs you accept.
  • If y'all don't submit the attribute, the default value is yeah
  • Your production'due south category type determines which unique product identifiers (GTIN, MPN, brand) are required.
  • Submit the identifier exists attribute and set the value to no if:
    • Your product is a media detail and the GTIN is unavailable (Annotation: ISBN and SBN codes are accustomed as GTINs
    • Your product is an apparel (habiliment) item and the brand is unavailable
    • In all other categories, your product doesn't have a GTIN, or a combination of MPN and brand
  • If a production does accept unique production identifiers, don't submit this aspect with a value of "no" or the production may be disapproved.

Detailed product clarification

These attributes are used to submit particular production characteristics that users commonly search for. The attributes can help yous control how your products show when you lot show products that accept variants. These attributes are also used to aid potential customers filter past attributes when searching for products on Google. Learn more than most how to submit variants.

Attribute Format Minimum requirements at a glance
Condition [condition]

Required if your production is used or refurbished

Optional for new products

The condition of your product at time of auction

Case
new

Supported values

  • New [new]
    Brand new, original, unopened packaging
  • Refurbished [refurbished]
    Professionally restored to working order, comes with a warranty, may or may not have the original packaging
  • Used [used]
    Previously used, original packaging opened or missing

Schema.org property
Offer.​itemCondition

Adult [adult]

Required (If a product contains adult content)
Signal a product includes sexually suggestive content

Instance
yes

Supported values

  • Aye [yes]
  • No [no]
  • Set up the value of this aspect to yep if this individual product contains nudity or sexually suggestive content. If you lot don't submit the attribute, the default value is no. Acquire about the adult-oriented content policy
  • If your website is mostly focused on an adult audition and contains adult-oriented content with or without nudity, navigate to your Merchant Centre business relationship, click on the tool icon Tools and setting menu icon [Gear] to open the "Tools and settings" card, then select Shopping ads setup. Expand the "Adult content" panel, and bank check the box abreast "My website primarily contains adult-oriented content (for instance, erotic lingerie) as defined by Google's Policy." If you lot bank check the box, you don't demand to submit the adult [adult] attribute for private products.
Multipack [multipack]

Required (For multipack products in Australia, Brazil, Czechia, France, Frg, Italy, Japan, Netherlands, Spain, Switzerland, the UK and the US)

Required for enhanced free listings on Google if you've created a multipack

Optional for all other products and countries of sale

The number of identical products sold inside a merchant-defined multipack

Example
vi

Syntax
Integer

  • Submit this attribute if you defined a custom group of identical products and are selling them as a single unit of sale. For example, you're selling half-dozen confined of soap together
  • Submit the number of products in your multipack. If you don't submit the attribute, the default value is 0
  • If the product'south manufacturer assembled the multipack instead of you lot, don't submit this attribute
Packet [is_bundle]

Required (For bundles in Commonwealth of australia, Brazil, Czechia, France, Germany, Italy, Japan, Netherlands, Spain, Switzerland, the Uk and the Us)

Required for enhanced free listings on Google if you've created a bundle containing a main production

Optional for all other products and countries of auction

Indicates a product is a merchant-defined custom group of different products featuring one primary product

Instance
yes

Supported values

  • Yes [yep]
  • No [no]
  • Submit yeah if y'all're selling a custom parcel of dissimilar products that yous created, and the parcel includes a main product. For example, a camera combined with a lens and purse. If yous don't submit the attribute, the default value is no
  • Don't use this aspect for bundles without a clear primary product. For instance, a gift handbasket containing cheese and crackers
Free energy efficiency grade [energy_efficiency_class]

Optional (except when required by local law or regulations)

Your production's free energy label

Instance
A+

Supported values

  • A+++
  • A++
  • A+
  • A
  • B
  • C
  • D
  • E
  • F
  • Chiliad
  • Include the legally required free energy label
  • To be used in combination with minimum energy efficiency class [min_energy_​​efficiency_​​class] and maximum free energy efficiency class [max_energy_efficiency_class] to create an energy efficiency label, for case, A+ (A+++ to G).

Minimum energy efficiency course [min_energy_efficiency_class]

Optional (except when required past local laws or regulations)

Available for Eu & CH simply

Your product'southward free energy label

Case
A+++

Supported values

  • A+++
  • A++
  • A
  • B
  • C
  • D
  • E
  • F
  • G
  • Include the legally required energy label
  • To be used in combination with energy efficiency form [energy_​​efficiency_class] and maximum energy efficiency class [max_energy_efficiency_class] to create an energy efficiency label, for example, A+ (A+++ to D).

Maximum energy efficiency class [max_energy_efficiency_class]

Optional (except when required by local laws or regulations)

Available for European union & CH only

Your product's energy label

Example
D

Supported values

  • A+++
  • A++
  • A
  • B
  • C
  • D
  • E
  • F
  • Yard
  • Include the legally required free energy label
  • To exist used in combination with energy_​​efficiency_​​class and min_energy_efficiency_class to create an free energy efficiency label, for instance, A+ (A+++ to D).

Historic period group [age_group]

Required (For all apparel products that are targeted to people in Brazil, France, Germany, Japan, the U.k., and the US besides as all products with assigned age groups)

Required for enhanced gratis listings for all Apparel & Accessories (ID: 166) products

Optional for all other products and countries of sale

The demographic for which your product is intended

Example
infant

Supported values

  • Newborn [newborn]
    0-3 months onetime
  • Infant [infant]
    3-12 months old
  • Toddler [toddler]
    1-v years old
  • Kids [kids]
    v-thirteen years old
  • Adult [adult]
    Teens or older


Schema.org property

  • Product.​audience.​suggestedMinAge
  • Product.​audience.​suggestedMaxAge
  • Include one value per product
  • For variants
    • Include the same value for item group ID [item_​group_​id] and different values for historic period grouping
Color [color]

Required (For all apparel products in feeds that are targeted to Brazil, France, Federal republic of germany, Japan, the Uk, and the Us also equally all products available in different colors)

Required for enhanced free listings for all Apparel & Accessories (ID: 166) products

Optional for all other products and countries of sale

Your product's color(s)

Case
Blackness

Syntax
Max 100 alphanumeric characters (max twoscore characters per colour)

Schema.org property
Production.color

  • Don't apply a number such as "0", "2", or "4"
  • Don't use characters that aren't alphanumeric such as "#fff000"
  • Don't use only 1 alphabetic character such as R (For Chinese, Japanese, or Korean languages, yous tin include a single character such as 红)
  • Don't reference the product or image such as "see image"
  • Don't combine several color names into 1 give-and-take, such as "RedPinkBlue". Instead, separate them with a /, such as "Ruby-red/Pinkish/Blue". Don't utilise a value that isn't a colour, such as "multicolor", "various", "diversity", "men's", "women's", or "N/A".
  • If your production features multiple colors, listing the principal color first.
  • For variants
    • Include the same value for particular group ID [item_​group_​id] and unlike values for color [color]
Gender [gender]

Required (Required for all apparel items in feeds that are targeted to people in Brazil, France, Frg, Nippon, the UK, and the US as well as all gender-specific products)

Required for enhanced free listings for all Google Apparel & Accessories (ID:166) products

Optional for all other products and countries of auction

The gender for which your product is intended


Example
Unisex

Supported values

  • Male person [male person]
  • Female [female person]
  • Unisex [unisex]

Schema.org property
Product.​audience.​suggested​Gender

  • For some Clothes & Accessories (ID:166) categories like Shoelaces (ID:1856), this attribute is recommended instead of required since these categories aren't dependent on gender
  • For variants
    • Include the aforementioned value for item grouping ID [item_​group_​id] and dissimilar values for gender
Material [fabric]

Required (if relevant for distinguishing different products in a set of variants)

Optional for all other products

Your product'due south textile or material

Example
leather

Syntax
Max 200 characters

Schema.org holding
Product.fabric

  • To indicate multiple materials for a single product (non variants), add a primary cloth, followed by up to two secondary materials, separated by a /. For example, instead of "CottonPolyesterElastane", use "cotton/polyester/elastane"
  • For variants
    • Include the aforementioned value for the item group ID [item_​group_​id] attribute and unlike values for the material attribute
Blueprint [pattern]

Required (if relevant for distinguishing different products in a fix of variants)

Optional for all other products

Your product'due south design or graphic print

Example
striped
polka dot
paisley

Syntax
Max 100 characters

Schema.org belongings
Product.pattern

  • For variants
    • Include the same value for the item group ID [item_​group_​id] attribute and different values for the pattern attribute
Size [size]

Required (Required for all dress products in Apparel & Accessories > Wearable (ID: 1604 ) and Apparel & Accessories > Shoes (ID: 187 ) product categories targeted to people in Brazil, France, Federal republic of germany, Japan, the UK, and the United states as well as all products available in different sizes)

Required for enhanced free listings for all Apparel & Accessories > Clothing (ID:1604) and Dress & Accessories > Shoes (ID:187) products.

Optional for all other products and countries of auction

Your product'due south size

Example
Twoscore

Syntax
Max 100 characters

Schema.org property
Product.size

  • For variants:
    • Include with the aforementioned value for item group ID [item_​group_​id] and dissimilar values for size [size]
  • If sizes contain multiple dimensions, condense them into i value. For example, "16/34 Tall" for neck size 16 inches, sleeve length 34 inches, and "Tall" fit
  • If your item is 1 size fits all or one size fits most, you can use one_size, Bone, one_size fits_all, OSFA, one_size_fits_most, or OSFM
  • For merchant-defined multipack products, submit the multipack quantity using the multipack [multipack] attribute. Do non submit the multipack quantity under the size attribute
Size type [size_type]

Optional (Available for apparel products only)

Your apparel production'southward cut

Instance
maternity

Supported values

  • Regular [regular]
  • Petite [petite]
  • Maternity [maternity]
  • Big [big]
  • Tall [tall]
  • Plus [plus]
  • Submit upwards to 2 values
  • If yous don't submit the attribute, the default value is regular
Size system
[size_system]

Optional (Available for apparel products only)

The country of the size arrangement used by your production

Example
US

Supported values

  • Usa
  • UK
  • European union
  • DE
  • FR
  • JP
  • CN
  • It
  • BR
  • MEX
  • AU
  • If you don't submit the attribute, the default value is your country of sale
Item group ID
[item_group_id]

Required (Brazil, France, Frg, Japan, the United Kingdom, and the United states if the product is a variant)

Required for enhanced free listings for all production variants

Optional for all other products and countries of sale

ID for a grouping of products that come up in dissimilar versions (variants)

Example
AB12345

Syntax
Max 50 alphanumeric characters

Schema.org belongings
Production.​inProductGroupWithID

  • Utilize a unique value for each group of variants. Use the parent SKU where possible
  • Keep the value the same when updating your product data
  • Apply only valid unicode characters
  • Apply an particular group ID for a set of products that differ by ane or more than of these attributes:
    • Color [colour]
    • Size [size]
    • Blueprint [pattern]
    • Material [fabric]
    • Age grouping [age_group]
    • Gender [gender]
  • Include the same attributes for each production in the item group. For example, if a product varies past size and color, submit size [size] and color [color] for every product that share the same value for item grouping ID [item_​group_​id]
  • If your products differ past pattern elements that aren't represented past the attributes to a higher place, don't use detail group ID
Product length
[product_length]

Optional

Your production's length

Instance
twenty in

Syntax
Number + unit

Supported values
one-3000

  • Decimal values are supported

Supported units

  • ​​cm
  • in
  • Include as many of the production measurement attributes equally possible.
  • Use the same unit of measurement for each product dimension aspect (including product length, width, and height). Otherwise, the data won't be displayed.
Product width
[product_width]

Optional

Your product's width

Example
20 in

Syntax
Number + unit

Supported values
1-3000

  • Decimal values are supported

Supported units

  • ​​cm
  • in
  • Include as many of the product measurement attributes as possible.
  • Use the same unit of measurement for each production dimension aspect (including production lengths, width, and tiptop). Otherwise, the information won't exist displayed.
Product top
[product_height]

Optional

Your product's height

Example
twenty in

Syntax
Number + unit

Supported values
i-3000

  • Decimal values are supported

Supported units

  • ​​cm
  • in
  • Include every bit many of the product measurement attributes as possible.
  • Employ the same unit of measurement for each product dimension attribute (including product lengths, width, and height). Otherwise, the information won't be displayed.
Product weight
[product_weight]

Optional

Your production's weight

Example
3.5 lb

Syntax
Number + unit

Supported values
0-2000

  • Decimal values are supported

Supported units

  • ​​lb
  • oz
  • one thousand
  • kg
  • Employ the actual assembled product weight for this attribute. If your product comes in multiple pieces, for example, as part of a bundle, use the complete weight of all the pieces in the listing.

Product detail
[product_detail]

Optional

Technical specifications or additional details of your production

Example
General:Product Type:Digital thespian

Syntax
This attribute uses three sub-attributes:

  • Department proper name [section_name]: Max 140 characters
  • Aspect proper name [attribute_name]: Max 140 characters
  • Attribute value [attribute_value]: Max 1000 characters
  • Don't add together information covered in other attributes, all capital letters, gimmicky foreign characters, promotion text, or list keywords or search terms
  • Don't add together information such as price, sale price, sale dates, shipping, delivery appointment, other fourth dimension-related information, or your company'due south name
  • Only provide an attribute proper noun and value when the value is confirmed. For example, provide "Vegetarian=False" if a nutrient product is not vegetarian, and not just because False is the default value for Boolean attributes is imitation.

Production highlight [product_highlight]

Optional

The most relevant highlights of your products

Example
Supports thousands of apps, including Netflix, YouTube, and HBO Max

Syntax
Max 150 characters

  • Employ between ii and x product highlights
  • Describe simply the product itself
  • Don't list keywords or search terms
  • Don't include promotional text, all capital letter letters, or gimmicky foreign characters

Shopping campaigns and other configurations

These attributes are used to control how your production information is used when yous create advert campaigns in Google Ads.

Attribute Format Minimum requirements at a glance
Ads redirect [ads_redirect]

Optional

A URL used to specify additional parameters for your production folio. Customers will exist sent to this URL rather than the value that yous submit for the link [link] or mobile link [mobile_link] attributes

Example
http://www.example.com/production.html

Syntax
Max 2000 characters

  • Submit the same registered domain equally for the link [link]attribute (and the mobile link [mobile_link]attribute, if present).
  • Valid registered domains include "example.com", "m-case.com", "case.co.uk", "example.com.ai", and "bar.tokyo.jp". URLs submitted with invalid domains, such equally "example.zz" or "example.comic", volition non be accepted. For more details on valid registered domains, encounter ads redirect.

Custom label 0-iv [custom_label_0-4]

Optional
Label that you assign to a product to aid organize behest and reporting in Shopping campaigns

Example
Seasonal
Clearance
Vacation
Auction
Cost range

Syntax
Max 100 characters

  • Utilise a value that you'll recognize in your Shopping entrada. The value won't be shown to customers who see your ads and free listings.
  • Submit up to 5 custom labels per production by including this attribute multiple times:
    • custom_label_0
    • custom_label_1
    • custom_label_2
    • custom_label_3
    • custom_label_4
  • Apply only i,000 unique values for each custom characterization beyond your Merchant Center account
Promotion ID [promotion_id]

Optional (Required for promotions in Australia, France, Germany, India, the UK and the US)

An identifier that allows you lot to lucifer products to promotions

Example
ABC123

Syntax
Max 50 characters

  • Use a unique and case sensitive ID without spaces or symbols (for example, %, !)
  • To map specific promotions to specific products, submit the same promotion ID in your product data and promotion data
  • Submit up to ten promotion IDs for one product by including this attribute multiple times

Destinations

These attributes tin can exist used to control the dissimilar locations where your content tin can announced. For example, you could utilize this attribute if yous desire a production to announced in a dynamic remarketing campaign, simply not in a Shopping ads campaign.

Aspect Format Minimum requirements at a glance
Excluded destination [excluded_destination]

Optional

A setting that you can utilise to exclude a product from participating in a specific type of advertisement campaign

Instance
Shopping_ads

Supported values

  • Shopping_ads
  • Buy_on_Google_listings
  • Display_ads
  • Local_inventory_ads
  • Free_listings
  • Free_local_listings
Included destination [included_destination]

Optional

A setting that you lot tin can employ to include a product in a specific type of advertizement campaign

Example
Shopping_ads

Supported values

  • Shopping_ads
  • Buy_on_Google_listings
  • Display_ads
  • Local_inventory_ads
  • Free_listings
  • Free_local_listings
Excluded countries for Shopping ads
[shopping_ads_excluded_country]

Optional

A setting that allows you to exclude countries where your products are advertised on Shopping ads.

Only available for Shopping ads

Example
DE

Syntax
2 characters. Must be an ISO_3166-1_alpha-2 country code.

Suspension [pause]

Optional

A setting you can use to pause and quickly reactivate a product for all ads (including Shopping ads, Display ads, and local inventory ads). A product can be paused for upwards to 14 days. If a production is paused for more than 14 days it will be disapproved. To re-approve, remove the aspect.

Example
ads

Supported values
ads

Shipping

These attributes can exist used together with the account shipping settings to help you provide accurate aircraft costs and speeds. Customers rely on these shipping costs and speeds to aid them brand choices well-nigh what to buy, so information technology's important to take the fourth dimension to submit quality shipping information. Learn how to prepare business relationship shipping settings

Aspect Format Minimum requirements at a glance
Aircraft [shipping]

Optional

Shipping costs are required for Shopping ads for products with the post-obit countries of auction: Commonwealth of australia, Austria, Belgium, Canada, Czechia, French republic, Germany, Ireland, State of israel, Italy, the netherlands, Poland, South korea, Kingdom of spain, Switzerland, the UK, and the US

Shipping costs are required for gratis listings for all products in all countries of sale

You may too be required to provide aircraft costs based on local laws or regulations.

Optional (to specify additional countries your product ships to or destinations where shipping costs are not required)

Not available for Purchase on Google listings

Your product's shipping cost, aircraft speeds, and the locations your production ships to.

Supported prices
0–1000 USD (cheque for other currencies)

Example
US:CA:Overnight:16.00 USD:1:1:2:3

Syntax
This aspect uses the following sub-attributes:

  • Country [state] (Required)
    ISO 3166 country code
  • Region [region](Optional)
  • Postal code [postal_code](Optional)
  • Location ID [location_id] (Optional)
  • Location group name [location_group_name] (Optional)
  • Service [service] (Optional)
    Service class or shipping speed
  • Toll [toll] (Optional)
    Fixed aircraft toll, including VAT if required
  • Minimum handling time [min_handling_time] and maximum treatment fourth dimension [max_handling_time] (Optional)
    To specify handling time
  • Minimum transit time [min_transit_time] and maximum transit time [max_transit_time] (Optional)
    To specify transit fourth dimension
  • Use this setting when shipping costs for your product are non divers in your Merchant Heart account or when you need to override shipping costs or speeds defined in your Merchant Eye account.
Aircraft label [shipping_label]

Optional

Label that you assign to a product to assistance assign right aircraft costs in Merchant Middle account settings

Example
perishable

Syntax
Max 100 characters

  • Apply a value that you'll recognize in your business relationship aircraft settings. The value won't be shown to customers. Examples:
    • Sameday
    • Oversize
    • But FedEx
Aircraft weight [shipping_weight]

Optional (Required for carrier-calculated rates, a table based on weight, or a dominion based on weight in your business relationship shipping settings)

The weight of the product used to summate the shipping price

Supported weights

  • 0–2000 lbs for regal
  • 0–chiliad kgs for metric

Example
3 kg

Syntax
Number + unit

Supported units

  • lb
  • oz
  • k
  • kg
  • Submit this value if y'all prepare upward business relationship shipping settings for carrier-calculated rates or weight-based shipping services
Shipping length [shipping_length]

Optional (Required for carrier-calculated rates in your business relationship shipping settings)

The length of the product used to calculate the shipping cost by dimensional weight

Example
twenty in

Syntax
Number + unit

Supported values

  • ane - 150 for inches
  • 1 - 400 for cm

Supported units

  • in
  • cm
  • Submit this value if you set up account shipping settings for carrier-calculated rates
  • If you don't provide shipping dimension attributes while using carrier-calculated rates, Google won't be able to calculate rates based on the dimensional weight of the product. If that'due south the instance, we'll merely calculate the rates based on the value you provided in the shipping weight [shipping_weight] attribute
  • If y'all submit this attribute, submit all aircraft dimension attributes:
    • Shipping length [shipping_length]
    • Shipping width [shipping_width]
    • Shipping height [shipping_height]
  • Utilise the same unit for all shipping dimension attributes that apply to a single product
  • Keep in mind that Google doesn't automatically calculate additional shipping cost for oversized products. If your package would exist considered large or oversized by your carrier, you should either use the shipping [aircraft] attribute to set shipping cost for an individual product or use the aircraft label [shipping_label] attribute with account aircraft settings to set the price
Shipping width [shipping_width]

Optional (Required for carrier-calculated rates in your business relationship shipping settings)

The width of the product used to calculate the shipping cost by dimensional weight

Instance
xx in

Syntax
Number + unit of measurement

Supported values

  • ane - 150 for inches
  • 1 - 400 for cm

Supported units

  • in
  • cm
  • Meet the requirements for the shipping length [shipping_​length] attribute
Shipping height [shipping_height]

Optional (Required for carrier-calculated rates in your account shipping settings)


The acme of the product used to calculate the shipping cost past dimensional weight

Example
20 in

Syntax
Number + unit

Supported values

  • ane - 150 for inches
  • 1 - 400 for cm

Supported units

  • in
  • cm
  • Come across the requirements for the shipping length [shipping_​length] attribute
Ships from country [ships_from_country]

Optional

A setting that allows you to provide the country from which your product will typically ship.

Example
DE

Syntax
2 characters. Must exist an ISO_3166-1_alpha-ii land code.

  • Provide only the state from which yous typically ship this product
Transit time characterization [transit_time_label]

Optional

Label that y'all assign to a product to help assign different transit times in Merchant Middle account settings.

Case
From Seattle

Syntax
Max 100 characters

  • Use a value that you'll recognize in your business relationship shipping settings. The value won't exist shown to customers. Examples:
    • Domestic dog food
    • From Seattle
    • Heavy package
Maximum handling time [max_handling_time]

Optional

The longest corporeality of time between when an order is placed for a product and when the product ships.

Instance
3

Syntax
Integer, greater than or equal to 0

  • Submit this attribute if you want to brandish the overall time information technology takes for a product to arrive at its destination
  • Submit the number of business days (as configured in Merchant Centre)
  • For products ready to be shipped the same day, submit 0
  • For submitting a fourth dimension range submit maximum handling time [max_handling_time] in combination with minimum handling time [min_handling_time]
Minimum handling fourth dimension [min_handling_time]

Optional
The shortest corporeality of time between when an guild is placed for a product and when the product ships.

Case
one

Syntax
Integer, greater than or equal to 0

  • Run across the requirements for the maximum handling time [max_handling_time] aspect
Attribute Format Minimum requirements at a glance
Taxation [tax]

Required (Bachelor for the US simply)
Your product'due south sales tax rate in percent

Example
U.s.a.:CA:5.00:y

Syntax
This attribute uses four sub-attributes:

  • Rate [rate] (required)
    Tax charge per unit equally a percentage
  • Land [state] (optional)
    ISO 3166 country lawmaking
  • Region [region] or postal code [postal_​code] or location ID [location_​id] (optional)
  • Aircraft tax [tax_​send] (optional)
    Specify if y'all charge revenue enhancement on shipping.
  • Supported values:
    • yes or no
  • Use this setting but to override the business relationship tax settings for an private product. We recommend that y'all submit tax information for all your products using the account settings in Merchant Center
  • For the Us and Canada
    • Don't include taxation in the toll [ price ] aspect. For the US but, include the tax in the tax aspect if you need to override your business relationship settings
  • For all other countries
    • Include value added revenue enhancement (VAT) or Appurtenances and Services Tax (GST) in the toll attribute and exercise non utilize the revenue enhancement attribute
Taxation category [tax_category]

Optional(Recommended for custom tax rates at the account level)
A category that classifies your product by specific tax rules

Example
Apparel

Syntax
Max 100 characters

  • Use this attribute if you have products that accept a specific tax rate.
    • Category labels in your product information must match the labels you enter in the Categories section in Merchant Center.

Was this helpful?

How can we improve it?