Add markup to your product pages so Google can provide detailed product information in rich Search results — including Image Search. Users can see price, availability, and review ratings right on Search results.
Using markup to enable rich product results lets you attract potential buyers while they are searching for items to buy on Google or images that include products you sell. 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 results (previously known as 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
Product markup enables a badge on the image in mobile image search results, which can encourage more users to click your content.
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 guidelines 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.
To include product information in Image Search, follow these guidelines for required markup:
- To show your product information in the rich image viewer: Include the
name,image,price, andpriceCurrencyproperties. Alternatively, instead ofpriceandpriceCurrency, you can include any four properties and excludeprice. - To show your product information in the Related Items feature: Include the
name,image,price,priceCurrency, andavailabilityproperties.
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 |
Repeated field of ImageObject or URL; required for Image Search, recommended for Search The URL of a product photo. Pictures clearly showing the product (for example, against a white background) are preferred. Additional image guidelines:
For example: "image": [
"https://example.com/photos/1x1/photo.jpg",
"https://example.com/photos/4x3/photo.jpg",
"https://example.com/photos/16x9/photo.jpg"
]
|
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, required for Related Items feature in Image Search, recommended for Search 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. |