If you're a merchant, you can give Google detailed product information that we can use to display rich results (for example, price, availability, and review ratings) right on Search results pages.
Using markup to enable rich product results lets you attract potential buyers while they are searching for items to buy on Google. You can maintain the accuracy and freshness of your product information, so your customers find the relevant, current items they're looking for.
This page explains how to mark up your product information so that Google can display rich snippets. There are two types of pages where you would typically use this markup:
- a product page that describes a single product
- a shopping aggregator page that lists a single product, along with information about different sellers offering that product
Examples
Single Product Page
| Microdata Example
|
RDFa Example
|
JSON-LD Example
|
Shopping Aggregator Page
| Microdata Example
|
RDFa Example
|
JSON-LD Example
|
Guidelines
Product rich results provide users with information about a specific product, such as its price, availability, and reviewer ratings. The following guidelines apply to product markup:
- Use markup for a specific product, not a category or list of products. For example, “shoes in our shop” is not a specific product. See also our structured data policies for multiple entities on the same page.
- Adult-related products are not supported.
- Reviewer’s name needs to be a valid name for a Person or Team For example, "James Smith" or"CNET Reviewers." By contrast, "50% off on Black Friday" is invalid.
Type definitions
Product information properties
When you mark up your content for product information, use the following properties of the schema.org Product type:
| Properties | |||
|---|---|---|---|
name |
Text, required The name of the product. |
||
image |
URL, recommended The URL of a product photo. Pictures clearly showing the product, e.g. against a white background, are preferred. |
||
description |
Text, recommended Product description. |
||
brand |
Text, recommended The brand of the product. |
||
review |
Review, recommended A nested Review of the product. |
||
aggregateRating |
AggregateRating, recommended A nested aggregateRating of the product. |
||
offers |
Offer, recommended An offer to sell the product. Includes a nested Offer or AggregateOffer. |
||
sku | gtin8 | gtin13 | gtin14 | mpn |
Text, recommended Various identification properties; these are described at schema.org/Product. Google recommends including brand and at least one identifier for each product. |
||
Offer Properties
When marking up offers within a product, use the following properties of the schema.org Offer type:
| Properties | |||
|---|---|---|---|
price |
Number, required The price of the product. Follow schema.org usage guidelines. |
||
priceCurrency |
Text, required The currency used to describe the product price, in three-letter ISO 4217 format. |
||
priceValidUntil |
Date, recommended The date (in ISO 8601 date format)
after which the price will no longer be available. (Your product snippet may not display
if the |
||
availability |
ItemAvailability, recommended Value is taken from a constrained list of options, expressed in markup using URL links.
Google also understands their short names (for example |
||
url |
URL, recommended A URL to the product web page (that includes the Offer). |
||
itemOffered |
Thing, recommended The item being sold. Typically, this includes a nested product, but it can also contain other item types or free text. |
||
Aggregate offer properties
An AggregateOffer is a kind of Offer representing an aggregation of other offers. When
marking up aggregate offers within a product, use the following properties of the schema.org
AggregateOffer type:
| Properties | |||
|---|---|---|---|
lowPrice |
Number, required The lowest price of all offers available. Floating point number. |
||
highPrice |
Number, recommended The highest price of all offers available. Floating point number. |
||
priceCurrency |
Text, required The currency used to describe the product price, in three-letter ISO 4217 format. |
||
offerCount |
Number, recommended The number of offers for the product. |
||