Review snippet

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:

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 ratings to your reviews.
  • 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.

Simple review

JSON-LD

Here's an example of a simple review in JSON-LD:

RDFa

Here's an example of a simple review in RDFa:

Microdata

Here's an example of a simple review in Microdata:

Embedded review

JSON-LD

Here's an example of a embedded review in JSON-LD:

RDFa

Here's an example of a embedded review in RDFa:

Microdata

Here's an example of a embedded review in Microdata:

Review with ratings

JSON-LD

Here's an example of a review with ratings in JSON-LD:

RDFa

Here's an example of a review with ratings in RDFa:

Microdata

Here's an example of a review with ratings in Microdata:

Aggregate rating

JSON-LD

Here's an example of an aggregate rating in JSON-LD:

RDFa

Here's an example of an aggregate rating in RDFa:

Microdata

Here's an example of an 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 of Organization 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.

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

Person or Organization

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

Thing

The item that is being reviewed. However, if the review is embedded into another schema.org type using the review property, you can omit the itemReviewed property. The valid types for the reviewed item are:
itemReviewed.name

Thing

The name of the item that is being reviewed. If the review is embedded into another schema.org type using the review property, you still need to provide the name of the thing that is being reviewed. For example:

{
  "@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

Rating

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

Number or Text

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 bestRating and worstRating.
Recommended properties
datePublished

Date

The date that the review was published, in ISO 8601 date format.

reviewRating.bestRating

Number

The highest value allowed in this rating system. The bestRating property is only required if the rating system is not on a 5-point scale. If bestRating is omitted, 5 is assumed.
reviewRating.worstRating

Number

The lowest value allowed in this rating system. The worstRating property is only required if the rating system is not on a 5-point scale. If worstRating is omitted, 1 is assumed.

AggregateRating

The full definition of AggregateRating is available at schema.org/AggregateRating.

Required properties
itemReviewed

Thing

The item that is being rated. However, if the aggregate rating is embedded into another schema.org type using the aggregateRating property, you can omit the itemReviewed property. The valid types for the reviewed item are:
itemReviewed.name

Thing

The name of the item that is being reviewed. If the review is embedded into another schema.org type using the review property, you still need to provide the name of the thing that is being reviewed. For example:

{
  "@context": "https://schema.org/",
  "@type": "Game",
  "name": "Firefly",
  "aggregateRating": {
    "@type": "AggregateRating",
    "ratingValue": "88",
    "bestRating": "100",
    "ratingCount": "20"
  }
}
ratingCount

Number

The total number of ratings for the item on your site. At least one of ratingCount or reviewCount is required.
reviewCount

Number

Specifies the number of people who provided a review with or without an accompanying rating. At least one of ratingCount or reviewCount is required.

ratingValue

Number or Text

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 bestRating and worstRating.
Recommended properties
bestRating

Number

The highest value allowed in this rating system. The bestRating property is only required if the rating system is not a 5-point scale. If bestRating is omitted, 5 is assumed.
worstRating

Number

The lowest value allowed in this rating system. The worstRating property is only required if the rating system is not a 5-point scale. If worstRating is omitted, 1 is assumed.

Send feedback about...

This page
Documentation feedback
Search
Search
Product feedback