
A review snippet is a short excerpt of a review or a rating from a review website, usually an average of the combined rating scores from many reviewers. When Google finds valid reviews or ratings markup, we may show a rich snippet that includes stars and other summary info from reviews or ratings. In addition to the text of the review, a rating is an evaluation described on a numeric scale (such as 1 to 5). Review snippets may appear in rich results or Google Knowledge Panels. You can supply ratings for the following content types:
Google also supports reviews for the following schema.org types:
CreativeWorkSeason
CreativeWorkSeries
Episode
Game
MediaObject
MusicPlaylist
MusicRecording
Organization
Examples
There are several ways you can add review structured data to a page:
- Add a simple review.
- Embed a review into another schema.org type using its review property.
- Add aggregate ratings. You can omit the rating for an individual review if your marked-up content contains both an author and a review date. For aggregate reviews, you must supply the average rating for the rich snippet to display.
- Embed aggregate ratings into another schema.org type using its aggregateRating property.
Simple review
Here's an example of a simple review in JSON-LD:
Here's an example of a simple review in RDFa:
Here's an example of a simple review in Microdata:
Embedded review
Here's an example of an embedded review in JSON-LD:
Here's an example of an embedded review in RDFa:
Here's an example of an embedded review in Microdata:
Aggregate rating
Here's an example of an aggregate rating in JSON-LD:
Here's an example of an aggregate rating in RDFa:
Here's an example of an aggregate rating in Microdata:
Embedded aggregate rating
Here's an example of an embedded aggregate rating in JSON-LD:
Here's an example of an embedded aggregate rating in RDFa:
Here's an example of an embedded aggregate rating in Microdata:
Guidelines
Your content must follow these guidelines to be eligible to appear as a rich result.
Technical guidelines
- Make sure to mark up an aggregate evaluation of an item by many people with schema.org/AggregateRating. Google may display aggregate ratings as rich snippets or, for certain types of items, answers in search results.
- Refer clearly to a specific product or service by nesting the review within the markup of
another schema.org type, such as schema.org/Book or
schema.org/Recipe, or by using a
schema.org type as a value for the
itemReviewed
property. - Make sure the reviews and ratings you mark up are readily available to users from the marked-up page. It should be immediately obvious to users that the page has review content.
- Provide review information about a specific item, not about a category or a list of items. For examples, refer to the common errors associated with list items.
- If the review snippet is for a local business or an organization, you must follow these additional guidelines:
- Pages using
LocalBusiness
or any other type ofOrganization
structured data are ineligible for star review feature if the entity being reviewed controls the reviews about itself. For example, a review about entity A is placed on the website of entity A, either directly in their structured data or through an embedded third-party widget. - Ratings must be sourced directly from users.
- Don't rely on human editors to create, curate, or compile ratings information for local businesses; instead, use critic review structured data.
- Sites must collect ratings information directly from users and not from other sites.
- Pages using
Structured data type definitions
You must include the required properties for your structured data to display in search results. You can also include the recommended properties to add more information to your structured data, which could provide a better user experience.
Review
The full definition of Review
is available at
schema.org/Review.
Required properties | |
---|---|
author |
The author of the review. The reviewer’s name must be a valid name. For example, "50% off until Saturday" is not a valid name for a reviewer. |
itemReviewed
|
The item that is being reviewed. However, if the review is embedded into another
schema.org type using the
|
itemReviewed.name
|
The name of the item that is being reviewed. If the review is embedded into another
schema.org type using the
{ "@context": "https://schema.org/", "@type": "Game", "name": "Firefly", "review": { "@type": "Review", "reviewRating": { "@type": "Rating", "ratingValue": "5" }, "author": { "@type": "Person", "name": "John Doe" }, "reviewBody": "I really enjoyed this game. You get to capture fireflies and put them in jars." } } |
reviewRating
|
The rating given in this review. The rating can be a nested Rating or more specific subtype. The most typical subtype is AggregateRating. |
reviewRating.ratingValue
|
A numerical quality rating for the item, either a number, fraction, or percentage.
(for example, "4", "60%", or "6 / 10"). If the scale is not implicit (for example, "4")
a 1 to 5 scale is assumed. If another scale is intended, use |
Recommended properties | |
---|---|
datePublished |
The date that the review was published, in ISO 8601 date format. |
reviewRating.bestRating
|
The highest value allowed in this rating system. The
|
reviewRating.worstRating
|
The lowest value allowed in this rating system. The |
AggregateRating
The full definition of AggregateRating
is available at
schema.org/AggregateRating.
Required properties | |
---|---|
itemReviewed
|
The item that is being rated. However, if the aggregate rating is embedded into
another schema.org type using the
|
itemReviewed.name
|
The name of the item that is being reviewed. If the review is embedded into another
schema.org type using the
{ "@context": "https://schema.org/", "@type": "Game", "name": "Firefly", "aggregateRating": { "@type": "AggregateRating", "ratingValue": "88", "bestRating": "100", "ratingCount": "20" } } |
ratingCount
|
The total number of ratings for the item on your site. At least one of
|
reviewCount
|
Specifies the number of people who provided a review with or without an accompanying
rating. At least one of |
ratingValue
|
A numerical quality rating for the item, either a number, fraction, or percentage.
(for example, "4", "60%", or "6 / 10"). If the scale is not implicit (for example, "4")
a 1 to 5 scale is assumed. If another scale is intended, use |
Recommended properties | |
---|---|
bestRating
|
The highest value allowed in this rating system. The |
worstRating
|
The lowest value allowed in this rating system. The |