My Tool Studio
Schema

Review Schema Generator

This review schema generator writes Review and AggregateRating JSON-LD for Google's review snippet, the stars under a search result. Mark up one review, an average rating from many users, or both on the item. Pick what is reviewed from 18 supported types, such as Product, Book, Movie, Course, Recipe, Software app or Restaurant, and the form shows the fields that type needs. Reviews can carry a title, date, publisher, a rating on any scale, and pros and cons for product reviews. Choose a standalone Review with itemReviewed or nest it inside the item. Review sites and bloggers use it for product and book reviews. The page also explains when Google ignores stars, such as reviews a business hosts about itself.

Always freeNo sign upRuns in your browser
Import existing JSON-LD(paste code or read it from a URL)

Paste a Review, an AggregateRating, or an item (such as a Product) that carries review or aggregateRating.

What are you marking up?

Structure

Both are valid. Nest it when the page is about the item (a product page). Use itemReviewed when the page is the review itself (a review article).

The item being reviewed

The review

Rating *

Scale
to
  • ReviewMissing required author.
  • ReviewMissing required reviewRating.
  • ReviewRecommended: add datePublished.
  • Add the review text. Google wants reviews that are visible on the page.
Output
<script type="application/ld+json">
{
  "@context": "https://schema.org",
  "@type": "Review",
  "itemReviewed": {
    "@type": "Product"
  }
}
</script>
Test in Google Rich Results TestValidate at validator.schema.orgThe test links copy your code first. Paste it into the tester's Code tab.

How to use

01

Choose what to mark up

Pick One review, Average rating or Both, then choose the structure: a standalone review with itemReviewed, or the item with the rating nested inside.

02

Describe the item and the rating

Choose the item type and fill its name and details. Add the reviewer, the star rating and scale, the review text and any pros and cons, or the average with a rating or review count.

03

Validate and copy

Clear the errors in the Validation panel, choose JSON-LD or Microdata, press Copy script and check it with Test in Google Rich Results Test.

Why Review Schema Generator

Four valid review patterns

Google accepts reviews and ratings in four shapes. This generator writes all of them from the same fields, so pick the one that matches what the page is about.

PatternUse it whenSettings here
Review with itemReviewedThe page is a review articleOne review, Review with itemReviewed
Item with nested reviewThe page is about the item and shows one reviewOne review, Item with a nested review
AggregateRating with itemReviewedThe page shows only a rating summaryAverage rating, AggregateRating with itemReviewed
Item with rating and reviewA product or recipe page with an average and reviewsBoth

When review stars will not appear

Valid markup makes a page eligible, but Google may still skip the stars. The most common reasons are these.

  • The reviews are about the business that publishes them (self-serving), on a LocalBusiness or Organization page.
  • The reviews or rating are not visible on the page, or the markup and the page disagree.
  • The rating is copied from another site rather than collected by you.
  • The item type is not one Google supports for review snippets.
  • The reviewer name is a label such as 50% off or Admin instead of a real person or organization.

Common questions

Which item types can a review snippet cover?
Google supports reviews and ratings for Book, Course, CreativeWorkSeason, CreativeWorkSeries, Episode, Event, Game, HowTo, LocalBusiness, MediaObject, Movie, MusicPlaylist, MusicRecording, Organization, Product, Recipe and SoftwareApplication. The item type menu covers these, with Restaurant as a LocalBusiness subtype.
What does a Review need for Google's review snippet?
An author with a real name under 100 characters, a reviewRating with a ratingValue, and the item being reviewed with a name. Google recommends datePublished and the bestRating and worstRating of your scale. The Validation panel checks each of these.
What is the difference between Review and AggregateRating markup?
A Review is one person's or publication's opinion with its own rating. An AggregateRating is the average of many ratings and needs a ratingCount or reviewCount. A product page can carry both: the average from all buyers and one featured review.
Should I nest the review or use itemReviewed?
Both are valid. Nest the review or rating inside the item when the page is about the item, such as a product page. Use a standalone Review with itemReviewed when the page is the review, such as a review article about someone else's product.
Why won't Google show stars for reviews of my own business?
Google treats them as self-serving. When a LocalBusiness or Organization publishes reviews about itself on its own site, directly or through an embedded widget, those pages are not eligible for review stars. The markup is still valid, and the tool shows a note when you pick those types.
How do I add pros and cons to a product review?
Type each advantage on its own line under Pros and each drawback under Cons. The tool writes them as positiveNotes and negativeNotes, each an ItemList of ListItem names. Google shows pros and cons for editorial product reviews, so the tool warns if you add them to another item type.
Can I use a rating scale other than 1 to 5?
Yes. Set the scale for the review or the average, such as 1 to 10 or 0 to 100. The values are written as worstRating and bestRating, and the Validation panel flags a rating outside that range. If you leave the defaults, Google assumes 1 to 5.
Can I copy ratings from another review site into my markup?
No. Google's guidelines say aggregate ratings must come from reviews collected on your own site or directly from your users, and the reviews must be visible on the page. Ratings pulled from other platforms are not allowed.
Can the review schema generator load markup I already have?
Yes. Paste a Review, an AggregateRating or an item that carries review or aggregateRating into Import existing JSON-LD, or read it from a URL. The tool detects the pattern and fills the item, review and rating fields.

More Schema tools

View all

Automatic Schema Markup Generator

Crawl your site, auto-detect + generate JSON-LD for every page

Schema
URL-first

Schema Markup Generator

JSON-LD or microdata for 10 types, plus a validator

Schema
URL-first

FAQ Schema Generator

Build FAQPage JSON-LD by hand, paste or URL import

Schema
URL-first

Article Schema Generator

Build Article, BlogPosting or NewsArticle JSON-LD

Schema
URL-first