Skip to content

Review Schema Generator - JSON-LD for Review Snippets

Import existing JSON-LD

Paste JSON-LD or a full <script> tag. Matching fields fill the form; properties the form doesn't cover are kept in the output as they are.

What Is Being Reviewed

Review

A real name, under 100 characters.

Google Search Preview
Preview not available for this type.
All Google requirements met

JSON-LD Output

What is Review schema?

Review schema is structured data that describes a single review: what was reviewed, who wrote the review, and the rating they gave. Google uses it to show star ratings under a search result. It is written in JSON-LD with the schema.org Review type.

The markup has three parts. itemReviewed names the thing being reviewed and its type, such as a Book or a Product. author names the person or organisation who wrote the review. reviewRating holds the score and, if you do not use a 1 to 5 scale, the best and worst possible scores.

Review schema example (JSON-LD)

A complete example you can adapt. Paste it into the page's HTML, or build your own with the generator above.

<script type="application/ld+json">
{
  "@context": "https://schema.org",
  "@type": "Review",
  "itemReviewed": {
    "@type": "Book",
    "name": "The Pragmatic Programmer"
  },
  "author": {
    "@type": "Person",
    "name": "Priya Raman"
  },
  "reviewRating": {
    "@type": "Rating",
    "ratingValue": 4,
    "bestRating": 5,
    "worstRating": 1
  },
  "datePublished": "2026-09-14",
  "reviewBody": "Still the best general book on day-to-day software craft. The chapters on tracer bullets and orthogonality have aged well; the tooling advice less so.",
  "publisher": {
    "@type": "Organization",
    "name": "Shelf Notes"
  }
}
</script>

Which Google rich result does it enable?

Valid Review markup makes a page eligible for a review snippet: gold stars, the rating, and sometimes the reviewer's name shown under the search result. It works for the 17 item types Google lists, from Book and Movie to Product and SoftwareApplication.

There is one large exception. If a business marks up reviews of itself on its own site, using LocalBusiness or Organization, Google will not show stars for it. Reviews of local businesses must also come from real users, not from editors who compile ratings.

Required and recommended properties

Property Status Notes
author Required A Person or Organization with a real name under 100 characters. Not a promotional phrase like "50% off today".
itemReviewed Required The reviewed thing, with its @type and name. Leave it out when the review is nested inside the reviewed item's own markup.
reviewRating.ratingValue Required The score, as a number or a string like "4". Decimals use a full stop.
datePublished Recommended The date the review was published, in ISO 8601 format.
reviewRating.bestRating Recommended Highest possible score. Defaults to 5.
reviewRating.worstRating Recommended Lowest possible score. Defaults to 1.

Common Review schema mistakes

  • Marking up reviews of your own business on your own site and expecting stars. Google treats these as self-serving and ignores them.
  • Using an item type Google does not support, such as Service or WebPage. The markup validates on schema.org but never shows stars.
  • Rating on a 10 point scale without setting bestRating to 10.
  • Putting a review in the markup that visitors cannot see on the page. The review text and rating must be visible.
  • Filling author with a site name, a slogan, or "Anonymous" when a real reviewer name is shown on the page.
  • Marking up reviews that were paid for or given in exchange for free products without saying so. Google's review guidelines, updated in July 2026, call out fake and undisclosed incentivised reviews.

Standalone or nested?

A standalone Review, like the one this generator builds, fits pages whose main purpose is the review itself: a book blog post, a film critique, or a software review article. If the page is a product or recipe page that happens to show reviews, add them to that page's Product or Recipe markup instead, under the review property. In that case drop itemReviewed, because the parent item is already the thing being reviewed. You can build that kind of markup with the Product schema generator or the Recipe schema generator.

Related Tools

Frequently Asked Questions

Can I add review stars to my own business's homepage?
Not if the reviews are about your own business. Google calls these self-serving reviews. Pages that use LocalBusiness or Organization markup are not eligible for review stars when the business controls the reviews about itself, and that includes reviews pulled in through a third-party widget.
What is the difference between Review and AggregateRating?
A Review is one person's opinion with one rating, such as a critic's review of a film. AggregateRating is the average of many ratings, such as 4.4 stars from 312 customers. Both can produce a review snippet. Use Review for a single editorial review and AggregateRating when you show a summary of many user ratings.
Which types of things can I review with this markup?
Google supports review snippets for Book, Course, CreativeWorkSeason, CreativeWorkSeries, Episode, Event, Game, HowTo, LocalBusiness, MediaObject, Movie, MusicPlaylist, MusicRecording, Organization, Product, Recipe, and SoftwareApplication. Reviews of other types are valid schema.org but will not get stars.
Do I need bestRating and worstRating?
They are recommended, not required. If you leave them out, Google assumes a 1 to 5 scale. If you rate out of 10 or out of 100, you must set bestRating, otherwise a 7 out of 10 will be read as 7 out of 5 and rejected.
Should the review be nested inside another schema type?
Often, yes. If the page already has Product or Recipe markup, put the review in that type's review property and leave out itemReviewed. Use a standalone Review, as this generator outputs, when the page is mainly a review of something, such as a book review or a software review article.