spyc.ai

Free tool

Review Schema Generator

Mark up a review with its rating, reviewer and the item reviewed, as Review JSON-LD.

How it works

What is the Review Schema Generator?

The Review Schema Generator is a free tool that writes Review structured data in JSON-LD for a single review. Choose what is being reviewed, then enter its name, the reviewer, the rating and the review text. It builds the nested itemReviewed and reviewRating blocks, and tells you which fields Google still needs.

How to use the Review Schema Generator

  1. Choose what is being reviewed, such as a product, book or course.
  2. Enter the item's name and the reviewer's name.
  3. Add the rating, the best possible rating, the date and the review text.
  4. Copy the code, paste it into the page showing the review, and validate it.

What is review schema?

Review schema is structured data for one person's review of one thing, using the schema.org Review type. It names the item in itemReviewed, the reviewer in author, and the score in reviewRating, with the text in reviewBody.

Its sibling, AggregateRating, summarises many reviews as an average and a count. Google can show either as stars and a score under a search result, which it calls a review snippet.

Which types can show review stars in Google?

Google shows review snippets for a fixed list of types, including Book, Course, Event, LocalBusiness, Movie, Organization, Product, Recipe and SoftwareApplication. Reviews of anything else are valid schema.org but will not produce stars.

The required properties are itemReviewed with its name, author, and reviewRating with a ratingValue. Add bestRating when your scale is not 1 to 5.

Why are my review stars not showing?

The most common reason is that the review is self-serving. Since 2019 Google has not shown stars for LocalBusiness or Organization reviews when the business being reviewed controls the page, whether the reviews are typed in directly or embedded from a widget.

Other causes: the review is not visible on the page, the reviewer is a company name instead of a person, the item type is outside the supported list, or Google simply chose not to show stars for that query. Valid markup makes a page eligible; it never guarantees the result.

Review or AggregateRating: which do I need?

Use Review when the page shows individual reviews, each with its own author and score, such as an editor's review of a laptop. Use AggregateRating when the page shows a summary, such as 4.6 from 128 customers.

A product page usually wants both, nested inside the Product. The Product Schema Generator writes the Product with its aggregate rating; this tool writes a standalone review.

What are Google's rules for review markup?

The review must be about a specific item, not a category or a list. It must be readily visible on the page that carries the markup. Ratings must come from real users or a named reviewer, not be invented or copied from another site. And the author's name must be a real person or team name, under 100 characters. Check the result with the Schema Markup Validator.

Questions

Can I mark up reviews copied from Google or Trustpilot?
No. Google's guidelines ask that reviews be collected by the site itself, not aggregated from other review sites.
What rating scale should I use?
Any scale works if you state it. Google assumes 1 to 5; for a 10-point or percentage scale, set bestRating to 10 or 100.
Can I add several reviews to one page?
Yes. Add each as its own Review, or nest them in a review array inside the item's own markup, such as a Product.
Do review stars improve click-through rate?
They make a result more noticeable, and many site owners report more clicks. Google publishes no figure, so treat any specific percentage you read with caution.
Is this schema generator free?
Yes, with a free spyc.ai account. The code is built in your browser as you type, so nothing you enter is sent to a server.

Technical SEO Tools

More in Technical SEO Tools

Opengraph Viewer

Paste a URL and see the card it produces when someone shares it — title, description, image.

View Opengraph

Open Graph Generator

Write the Open Graph tags, preview the card, copy the markup.

Generate Open Graph tags

Robots.txt Checker

Fetch any site's robots.txt and test one URL against it: allowed, or blocked by which rule.

View robots.txt

Ready when you are

Before your next buyer asks AI about you, ask AI about yourself

One check, four engines, about twenty seconds. We show you the answers before we ask for anything.