Reviews

A review is someone's evaluation of something. We support reviews and ratings for a wide range of schema.org types, including businesses, products, and different creative works such as books or movies.

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 examples

Simple review

Microdata Example

RDFa Example

JSON-LD Example

Embedded review

You can embed a review into another schema.org type using its review property.

Microdata Example

RDFa Example

JSON-LD Example

Simple review with rating

Microdata Example

RDFa Example

JSON-LD Example

Aggregate rating examples

Example of marking up an aggregate rating.

Microdata Example

RDFa Example

JSON-LD Example

Aggregate rating with no best score

Microdata Example

RDFa Example

JSON-LD Example

Guidelines

To be eligible for reviews and ratings rich snippets, be aware of the following extra guidelines:

  • Aggregate ratings: An aggregate evaluation of an item by many people should be marked up as a schema.org/AggregateRating. Google may display aggregate ratings as rich snippets or, for certain types of items, answers in search results, as shown below.
  • Refer clearly to a specific product or service. Do this by nesting the review or ratings within the markup of another schema.org type—such as schema.org/Book or schema.org/LocalBusiness —or by using that schema.org typed element 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 or ratings content.
  • Provide review and/or rating information about a specific item, not about a category or a list of items. For example, “hotels in Madrid,” “summer dresses,” or “cake recipes” are not specific items. See also our structured data guidelines for multiple entities on the same page.
  • No reviews are shown for adult-related products or services.
  • Single reviewer name needs to be valid. For example, "50% off until Saturday" is not a valid name for a reviewer.
  • Ratings that don't use a 5-point scale:

    By default, Google assumes that your site uses a 5-point scale, where 5 is the best possible rating and 1 is the worst, but you can use any other scale. If you do, you can mark up the best and worst ratings, and Google will scale that to the 5-star system used in rich snippets. The 10-point scale used above does just this. For further examples see below.

Type definitions

Review properties

Properties
itemReviewed

Thing, required*

The item that is being reviewed. This needs to be a valid schema.org type.

* If the review is embedded into another schema.org type using the review property, the itemReviewed property can be omitted.

reviewBody

Text, recommended

The actual body of the review.

author

Person or Organization, required

The author of the review. The reviewer’s name needs to be a valid name.

datePublished

Date, recommended

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

reviewRating

Rating, recommended

The rating given in this review. A nested Rating or more specific subtype, most typically AggregateRating.

reviewRating.ratingValue

Number, recommended

A numerical quality rating for the item.

reviewRating.bestRating

Number, required *

The highest value allowed in this rating system.

* Required if the rating system is not on a 5-point scale. If bestRating is omitted, 5 is assumed.

reviewRating.worstRating

Number, required *

The lowest value allowed in this rating system.

* Required if the rating system is not on a 5-point scale. If worstRating is omitted, 1 is assumed.

publisher

Organization, recommended

The publisher of the review.

Aggregated rating properties

Properties
itemReviewed

Thing, required*

The item that is being rated. This needs to be a valid schema.org type.

* If aggregate rating is embedded into another schema.org type, using aggregateRating property, then there is no need to mark up the itemReviewed property.

ratingCount

Number, required

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

reviewCount

Number, required

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, required

A numerical quality rating for the item.

bestRating

Number, required*

The highest value allowed in this rating system.

* Required if the rating system is not a 5-point scale. If bestRating is omitted, 5 is assumed.

worstRating

Number, required*

The lowest value allowed in this rating system.

* Required if the rating system is not a 5-point scale. If worstRating is omitted, 1 is assumed.

Send feedback about...