Review snippet

Does your site provide reviews from critics? Use critic review structured data.
Does your site provide reviews about other employers? Use Employer Aggregate Rating structured data.
Does your site review claims made by others? Use Fact check structured data.

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 Cards. You can supply ratings for the following content types:

• Books
• Local businesses
• Movies
• Music
• Products
• Recipes

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:

{ "@context": "https://schema.org/", "@type": "Review", "itemReviewed": { "@type": "Restaurant", "image": "http://www.example.com/seafood-restaurant.jpg", "name": "Legal Seafood", "servesCuisine": "Seafood", "telephone": "1234567", "address" :{ "@type": "PostalAddress", "streetAddress": "123 William St", "addressLocality": "New York", "addressRegion": "NY", "postalCode": "10038", "addressCountry": "US" } }, "reviewRating": { "@type": "Rating", "ratingValue": "4" }, "name": "A good seafood place.", "author": { "@type": "Person", "name": "Bob Smith" }, "reviewBody": "The seafood is great.", "publisher": { "@type": "Organization", "name": "Washington Times" } }

RDFa

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

<div vocab="https://schema.org/" typeof="Review"> <div property="itemReviewed" typeof="Restaurant"> <img property="image" src="https://developers.google.com/search/docs/data-types/seafood-restaurant.jpg" alt="Catcher in the Rye"/> <span property="name">Legal Seafood</span> <span property="servesCuisine">Seafood</span> <span property="telephone">1234567</span> <span property="address">123 William St, New York</span> </div> <span property="reviewRating" typeof="https://schema.org/Rating"> <span property="ratingValue">4</span> </span> stars - <b>"<span property="name">A good seafood place.</span>" </b> <span property="author" typeof="https://schema.org/Person"> <span property="name">Bob Smith</span> </span> <span property="reviewBody">The seafood is great.</span> <div property="publisher" typeof="Organization"> <meta property="name" content="Washington Times"> </div> </div>

Microdata

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

<div itemscope itemtype="https://schema.org/Review"> <div itemprop="itemReviewed" itemscope itemtype="https://schema.org/Restaurant"> <img itemprop="image" src="https://developers.google.com/search/docs/data-types/seafood-restaurant.jpg" alt="Catcher in the Rye"/> <span itemprop="name">Legal Seafood</span> <span itemprop="servesCuisine">Seafood</span> <span itemprop="telephone">1234567</span> <span itemprop="address">123 William St, New York</span> </div> <span itemprop="reviewRating" itemscope itemtype="https://schema.org/Rating"> <span itemprop="ratingValue">4</span> </span> stars - <b>"<span itemprop="name">A good seafood place.</span>" </b> <span itemprop="author" itemscope itemtype="https://schema.org/Person"> <span itemprop="name">Bob Smith</span> </span> <span itemprop="reviewBody">The seafood is great.</span> <div itemprop="publisher" itemscope itemtype="https://schema.org/Organization"> <meta itemprop="name" content="Washington Times"> </div> </div>

Embedded review

JSON-LD

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

{ "@context": "https://schema.org/", "@type": "Product", "image": "http://www.example.com/catcher-in-the-rye-book-cover.jpg", "name": "The Catcher in the Rye", "review": { "@type": "Review", "reviewRating": { "@type": "Rating", "ratingValue": "5" }, "name": "A masterpiece of literature", "author": { "@type": "Person", "name": "John Doe" }, "datePublished": "2006-05-04", "reviewBody": "I really enjoyed this book. It captures the essential challenge people face as they try make sense of their lives and grow to adulthood.", "publisher": { "@type": "Organization", "name": "Washington Times" } } }

RDFa

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

<div vocab="https://schema.org/" typeof="Product"> <img property="image" src="https://developers.google.com/search/docs/data-types/catcher-in-the-rye-book-cover.jpg" alt="Catcher in the Rye"/> <span property="name">The Catcher in the Rye</span> <div property="review" typeof="Review"> Review: <span property="reviewRating" typeof="Rating"> <span property="ratingValue">5</span> - </span> <b>"<span property="name">A masterpiece of literature</span>" </b> by <span property="author" typeof="Person"> <span property="name">John Doe</span></span>, written on <meta property="datePublished" content="2006-05-04">May 4, 2006 <div property="reviewBody">I really enjoyed this book. It captures the essential challenge people face as they try make sense of their lives and grow to adulthood.</div> <span property="publisher" typeof="Organization"> <meta property="name" content="Washington Times"> </span> </div> </div>

Microdata

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

<div itemscope itemtype="https://schema.org/Product"> <img itemprop="image" src="https://developers.google.com/search/docs/data-types/catcher-in-the-rye-book-cover.jpg" alt="Catcher in the Rye"/> <span itemprop="name">The Catcher in the Rye</span> <div itemprop="review" itemscope itemtype="https://schema.org/Review"> Review: <span itemprop="reviewRating" itemscope itemtype="https://schema.org/Rating"> <span itemprop="ratingValue">5</span> - </span> <b>"<span itemprop="name">A masterpiece of literature</span>" </b> by <span itemprop="author" itemscope itemtype="https://schema.org/Person"> <span itemprop="name">John Doe</span></span>, written on <meta itemprop="datePublished" content="2006-05-04">May 4, 2006 <div itemprop="reviewBody">I really enjoyed this book. It captures the essential challenge people face as they try make sense of their lives and grow to adulthood.</div> <span itemprop="publisher" itemscope itemtype="https://schema.org/Organization"> <meta itemprop="name" content="Washington Times"> </span> </div> </div>

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:

<span vocab="https://schema.org/" typeof="Review"> <span property="itemReviewed" typeof="Thing"> <span property="name">Super Book</span> </span> <span property="author" typeof="Person"> <span property="name">Joe</span> </span> <span property="reviewRating" typeof="Rating"> Rating: <span property="ratingValue">7</span> out of <span property="bestRating">10</span> </span> <span property="publisher" typeof="Organization"> <meta property="name" content="Washington Times"> </span> </span>

Microdata

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

<span itemscope itemtype="https://schema.org/Review"> <span itemprop="itemReviewed" itemscope itemtype="https://schema.org/Thing"> <span itemprop="name">Super Book</span> </span> <span itemprop="author" itemscope itemtype="https://schema.org/Person"> <span itemprop="name">Joe</span> </span> <span itemprop="reviewRating" itemscope itemtype="https://schema.org/Rating"> Rating: <span itemprop="ratingValue">7</span> out of <span itemprop="bestRating">10</span> </span> <span itemprop="publisher" itemscope itemtype="https://schema.org/Organization"> <meta itemprop="name" content="Washington Times"> </span> </span>

Aggregate rating

JSON-LD

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

{ "@context": "https://schema.org/", "@type": "Book", "name": "Super Book", "description": "Ultra interesting. Super impressive.", "aggregateRating": { "@type": "AggregateRating", "ratingValue": "88", "bestRating": "100", "ratingCount": "20" } }

RDFa

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

<div vocab="https://schema.org/" typeof="Book"> <h2 property="name"> Super Book </h2> <div property="description">Ultra interesting. Super impressive.</div> <div property="aggregateRating" typeof="AggregateRating"> <div>Book rating: <span property="ratingValue">88</span> out of <span property="bestRating">100</span> with <span property="ratingCount">20</span> ratings </div> </div> </div>

Microdata

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

<div itemscope itemtype="https://schema.org/Book"> <h2 itemprop="name"> Super Book </h2> <div itemprop="description">Ultra interesting. Super impressive.</div> <div itemprop="aggregateRating" itemscope itemtype="https://schema.org/AggregateRating"> <div>Book rating: <span itemprop="ratingValue">88</span> out of <span itemprop="bestRating">100</span> with <span itemprop="ratingCount">20</span> ratings </div> </div> </div>

Guidelines

Your content must follow these guidelines to be eligible to appear as a rich result.

Warning: If your site violates one or more of these guidelines, then Google may take manual action against it. Once you have remedied the problem, you can submit your site for reconsideration.

• Technical guidelines
• Content guidelines
• Webmaster guidelines
• General structured data guidelines

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/LocalBusiness, 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.

  Recommended: Hesperia Madrid Hotel

  Not recommended: Top 10 hotels in Madrid

• If the review snippet is for a local business, you must follow these additional guidelines:
  • 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. This needs to be a valid schema.org type. However, if the review is embedded into another schema.org type using the review property, you can omit the itemReviewed property.
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. This needs to be a valid schema.org type. However, if the 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 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.