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 appear in Google Search results may appear under a search result or in Google Knowledge Cards. You can supply ratings for the following content 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 using the Structured Data Testing Tool:

RDFa

Here's an example of a simple review in RDFa using the Structured Data Testing Tool:

Microdata

Here's an example of a simple review in Microdata using the Structured Data Testing Tool:

Embedded review

JSON-LD

Here's an example of a embedded review in JSON-LD using the Structured Data Testing Tool:

RDFa

Here's an example of a embedded review in RDFa using the Structured Data Testing Tool:

Microdata

Here's an example of a embedded review in Microdata using the Structured Data Testing Tool:

Review with ratings

JSON-LD

Here's an example of a review with ratings in JSON-LD using the Structured Data Testing Tool:

RDFa

Here's an example of a review with ratings in RDFa using the Structured Data Testing Tool:

Microdata

Here's an example of a review with ratings in Microdata using the Structured Data Testing Tool:

Aggregate rating

JSON-LD

Here's an example of an aggregate rating in JSON-LD using the Structured Data Testing Tool:

RDFa

Here's an example of an aggregate rating in RDFa using the Structured Data Testing Tool:

Microdata

Here's an example of an aggregate rating in Microdata using the Structured Data Testing Tool:

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/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 critic review 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.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.

Recommended properties
datePublished

Date

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

publisher

Organization

The publisher of the review.

reviewBody

Text

The actual body of the review.

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

A numerical quality rating for the item.

AggregateRating

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

Required 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.

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

A numerical quality rating for the item.

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.

Enviar comentarios sobre...