Skip to content
All articles

How do you add Review structured data to your pages?

guide // , 6 min read, by Darthwares

Adding Review and AggregateRating structured data to your web pages can enable Google to display rich snippets, which include star ratings and other summary information, in search results. Structured data is a standardized format for providing information about a page and classifying its content. This can make search results more engaging to users and might encourage them to interact more with your website.

A diagram showing a web page with review content, an embedded JSON-LD script block containing Review and AggregateRating structured data, and a search results page displaying a
On this page // 7 sections
  1. 01What are Review and AggregateRating structured data?
  2. 02How do you add Review structured data to your page?
  3. 03What content is eligible for review snippets?
  4. 04What are the requirements for displaying review snippets in Google Search?
  5. 05How do you check your Review structured data?
  6. 06What are product snippets and ratings?
  7. 07Common questions

The short version

  • Review structured data describes a single review, while AggregateRating summarizes multiple reviews.
  • Implement this data using JSON-LD embedded within your page's HTML.
  • Ensure all marked-up review content is visible to users on the page and is genuine.
  • Validate your structured data using tools like Google's Rich Results Test to identify and correct errors.
  • Google may display rich snippets with star ratings for valid and eligible review markup.

What are Review and AggregateRating structured data?

Structured data is a standardized format that provides information about a page and classifies its content. For example, on a recipe page, structured data can specify ingredients, cooking time, and calories. This information helps search engines understand the page's content.

Schema.org defines a Review as a critique of an item, such as a restaurant, movie, or store. This type of structured data describes a single review. When Google finds valid reviews or ratings markup, it may show a rich snippet that includes stars and other summary information from these reviews or ratings.

AggregateRating structured data, also defined by Schema.org, represents an overall rating based on a collection of multiple reviews or ratings. For rich snippets to display, you must supply the average rating. This rating system also defines properties for the highest and lowest allowed values.

How do you add Review structured data to your page?

Google recommends using JSON-LD to add structured data to your pages. JSON-LD is a JavaScript notation that you embed within a <script> tag in either the <head> or <body> elements of an HTML page. This method allows you to provide structured information about your page's content.

When implementing structured data, you must include all the required properties for an object to be eligible for enhanced display in Google Search. It is more important to supply fewer but complete and accurate recommended properties rather than trying to provide every possible recommended property with less complete, badly-formed, or inaccurate data.

What content is eligible for review snippets?

Google may show a rich snippet, which includes stars and other summary information, when it finds valid reviews or ratings markup on your page. For this to happen, the review content you mark up must be readily available and visible to users directly on that page. Do not add structured data about information that is not visible to the user, even if the information is accurate.

It is crucial not to include fake or undisclosed incentivized reviews on your page or in your structured data markup. Furthermore, Google documents that if the entity being reviewed controls the reviews about itself, their pages that use LocalBusiness or any other type of Organization structured data are ineligible for the star review feature.

To be eligible for review snippets in Google Search, you must provide valid and accurate structured data. Google may show a rich snippet with stars and other summary information when it finds such markup. All required properties for an object must be included for it to appear with an enhanced display.

For aggregate reviews, you must supply the average rating for the rich snippet to display. It is more important to provide fewer but complete and accurate recommended properties than to include many properties with incomplete or inaccurate data. The review content you mark up must also be readily available to users from the marked-up page; do not add structured data about information not visible to the user.

Google also states that you should not include fake or undisclosed incentivized reviews. Additionally, if the entity being reviewed controls the reviews about itself, pages using LocalBusiness or any other type of Organization structured data are ineligible for the star review feature.

How do you check your Review structured data?

After adding Review structured data to your pages, you should validate your code. Google's Rich Results Test is an easy and useful tool for this purpose. It helps you identify and fix any critical errors in your structured data.

The Rich Results Test can also, in some cases, provide a preview of how your feature might appear in Google Search results, helping you confirm your implementation is correct.

What are product snippets and ratings?

When you add structured data to your product pages, your product information can appear in richer ways in Google Search results, including Google Images and Google Lens. These enhanced displays are known as product snippets. Users can see details such as price, availability, review ratings, and shipping information directly in search results.

Product snippets are also applicable for product pages where people cannot directly purchase the product. This type of markup offers more options for specifying review information, such as identifying pros and cons on an editorial product review page, which can then be highlighted in search results. Providing customer reviews and ratings through structured data enhances the appearance of your search result.

Google notes that providing both structured data on web pages and a Merchant Center feed maximizes your eligibility for these experiences and helps Google correctly understand and verify your data.

Common questions

What is structured data?

Structured data is a standardized format for providing information about a page and classifying its content. For example, it can specify ingredients and cooking time on a recipe page. Google uses structured data that it finds on the web to understand the content of the page and gather information about the web and the world in general, such as details about people, books, or companies.

Why should I add Review structured data?

Adding Review structured data can enable search results that are more engaging to users, which are called rich results. When Google finds valid reviews or ratings markup, it may show a rich snippet that includes stars and other summary information. For product pages, this can mean users see price, availability, and review ratings directly in search results, encouraging more interaction with your website.

Can I add Review structured data for my own business's reviews?

Google documents that if the entity being reviewed controls the reviews about itself, their pages that use LocalBusiness or any other type of Organization structured data are ineligible for the star review feature. This means you cannot add Review structured data for reviews that your own business generates or controls about itself if you want the star feature to appear.

What is JSON-LD?

JSON-LD is a JavaScript notation that is the recommended format for adding structured data. You embed it within a <script> tag in the <head> or <body> elements of an HTML page. This allows you to provide structured information about your page's content in a standardized way that Google can easily process.

How can I test my Review structured data?

You can validate your Review structured data using Google's Rich Results Test. This tool is useful for identifying and fixing any critical errors in your structured data. In some cases, it can also provide a preview of how your structured data might appear as a rich feature in Google Search results.

Primary sources and further reading

This article was researched and written by an AI model and published automatically. It was written from sentences that were checked to appear on the pages below, but a person has not reviewed the text. If something is wrong, tell us at chibivikramathithan@darthwares.com and we will correct it.