Review schema, built to Google's rules
Fill in the item and its average rating or reviews, then copy valid Review and AggregateRating JSON-LD. Every field is checked against Google's review snippet rules as you type. It runs in your browser.
- Error: Enter the name of the item. Google needs it even when the rating is nested in the item.
- Error: Enter a rating value.
- Error: Add a number of ratings or a number of reviews. Google requires at least one of them.
Your JSON-LD
<script type="application/ld+json">
{
"@context": "https://schema.org",
"@type": "Product",
"name": "",
"aggregateRating": {
"@type": "AggregateRating",
"ratingValue": ""
}
}
</script>Add it to the page that shows these ratings or reviews, then test the live URL in Google's Rich Results Test
Check a live page
Already have review markup on a page? The schema markup validator in the AY Rank app reads its JSON-LD and microdata and lists missing required properties.
Need the rest of the markup?
Our schema generator builds Product, LocalBusiness, Organization and SoftwareApplication JSON-LD. You can move the aggregateRating or review part from this tool into it.
Pick what is reviewed
Choose one of the 17 types Google accepts, such as Product, Book, Course or SoftwareApplication, and give it a name.
Add the rating
Add an average rating with a count, individual reviews (up to 10), or both. Change the scale if it is not 1 to 5.
Read the checks
Errors and warnings follow Google's review snippet rules, including the author name limit and the self-serving review rule.
Copy and test
Copy the script tag, add it to the page that shows the reviews, and test the URL in Google's Rich Results Test.
When Google finds valid review markup, it may show stars and a rating summary with a search result. The markup has to describe ratings readers can see on the page, and Google can take manual action against sites that break its review guidelines. This tool writes the markup and flags the rules people break most often.
The rules this generator checks
- The item must be one of the 17 types Google lists for review snippets. The rating is nested inside the item, so itemReviewed is left out, which is what Google says to do for a nested review.
- The item needs a name, even when the rating is nested inside it.
- An average rating needs a ratingValue and at least one of ratingCount or reviewCount.
- Ratings use a dot for decimals (4.4, not 4,4) and must sit inside your scale. Google assumes 5 as the best and 1 as the worst rating when bestRating and worstRating are missing, so this tool only writes them when you change them.
- Each review needs an author, a Person or an Organization, with a real name shorter than 100 characters. "50% off until Saturday" is Google's own example of an invalid name.
- Review dates are written in ISO 8601 form (YYYY-MM-DD).
- If you list several reviews, add an average rating too, as Google asks.
- Reviews of a LocalBusiness or Organization shown on its own site, in markup or through an embedded widget, are not eligible for review stars. Tick the box under the item name and the tool marks this as an error.
- Some rules can't be checked by a form. The reviews must be visible on the page and about one specific item. They must not be copied from other websites, and they must not be fake or undisclosed incentivized reviews. Google lists all of these in its guidelines.
Sources
Read on 2026-11-12. Google's page was last updated on 2026-09-08.
- Google Search Central, Review snippet (Review, AggregateRating) structured data (last updated 2026-09-08)https://developers.google.com/search/docs/appearance/structured-data/review-snippet
- schema.org, Reviewhttps://schema.org/Review
- schema.org, AggregateRatinghttps://schema.org/AggregateRating
- schema.org, Rating (bestRating, worstRating)https://schema.org/Rating
Why your reviews widget can't earn stars on your own site
Google's example of a self-serving review is a review about entity A placed on the website of entity A, "either directly in their structured data or through an embedded third-party widget (for example, Google Business reviews or Facebook reviews widget)." Pages like that, when they use LocalBusiness or any other type of Organization markup, are ineligible for the star review feature. This rule covers businesses and organizations. Reviews of a product, a course or an app on its seller's site are a different case and fall under the other rules.
Frequently Asked Questions
What is review schema?
It is structured data that describes a review or a rating of one item, using schema.org Review and AggregateRating. When Google finds valid review markup, it may show a rich snippet with stars and other summary info from the reviews.
What is the difference between Review and AggregateRating?
A Review is one rating of the item, with an author. An AggregateRating is the average of many ratings, with a ratingCount or reviewCount. Google says to use AggregateRating for "an aggregate evaluation of an item by many people".
Can I add review stars for my own business?
Not with reviews of your own business shown on your own site. Google says that when the reviewed entity controls the reviews about itself, its pages that use LocalBusiness or Organization markup are ineligible for the star review feature. That includes embedded Google or Facebook review widgets.
Which schema types support review snippets?
Google lists 17: Book, Course, CreativeWorkSeason, CreativeWorkSeries, Episode, Event, Game, HowTo, LocalBusiness, MediaObject, Movie, MusicPlaylist, MusicRecording, Organization, Product, Recipe and SoftwareApplication. LocalBusiness and Organization are only for sites that capture reviews about other businesses.
Does valid review markup guarantee stars in Google?
No. Google says it does not guarantee that features that consume structured data will show up in search results. Valid markup makes a page eligible, and Google decides whether to show the rich result.
Want us to fix this for you?
Want structured data checked and fixed across your whole site? AY Rank's technical SEO work covers schema, crawlability and indexation.