Review Schema Generator

Build Review or AggregateRating JSON-LD for a product, book, movie, or other item Google accepts, with checks for the reviewer name, the item name, and the rating.

JSON-LD

Rich Results Test ↗

Missing required fields

  • Add the name of the item being reviewed. Google requires it.
  • Add the reviewer's name. Google requires a Person or Organization author.
  • Add a numeric ratingValue. Google requires reviewRating.ratingValue.

Recommended fields still open

  • Add the review text (reviewBody) that appears on the page.
  • Add the date the review was published (datePublished).
<script type="application/ld+json">
{
  "@context": "https://schema.org",
  "@type": "Product"
}
</script>

Paste the script into the page HTML, in the head or before </body>. Then open Google's Rich Results Test, choose the code tab, and paste it again.

Review on schema.org · Google's documentation

Want the marketing handled too?

SEOchat publishes pages about your business, keeps your Google listing active, and reports results every week. Starter is $99/month. Growth is $179/month. Cancel anytime.

A business name and website you already typed are carried into checkout. They do not change the price.

What this writes

The generator nests the review or the aggregate rating on the item. Google says to omit itemReviewed when the review sits on the parent, because the parent is the thing being reviewed. A standalone review with a disconnected item is easier to get wrong, so this tool does not write that shape.

Supported item types are the ones Google lists for review snippets, including Product, Book, Movie, Recipe, Course, Event, SoftwareApplication, and HowTo. LocalBusiness, Restaurant, and Organization are in the list with a warning, because those stars are only for sites reviewing someone else.

How to add this markup

  1. Show the review or the average on the page, including the reviewer name and the scale.
  2. Pick the item type and enter the same numbers. Use a dot for decimals, as in 4.6.
  3. Clear the required warnings. A rating outside the best and worst values is left out.
  4. Copy the script into that item's page, not into every page of the site.
  5. Test the code, then the live URL, in Google's Rich Results Test.

Self-serving reviews

If you are the business, do not describe your own Google star rating with this markup. Ask customers for reviews on Google instead, and keep the on-page reviews for products or third parties. A product page can use the product schema generator, which can carry an offer and an aggregate rating together. The company itself belongs in the organization schema generator or the local business schema generator, without self-written stars.

Questions

What does a review schema generator write?

Either one Review nested on the item, or an AggregateRating with an average and a count. Google can show stars from that markup on eligible types. The review has to be about the item, written by a real person or organization.

Can I mark up my own Google reviews?

No. Google calls that a self-serving review. LocalBusiness and Organization ratings are only for sites that collect reviews about other businesses. Marking up reviews you wrote about yourself can be ignored and can draw a manual action.

Which fields are required?

A review needs the item name, an author name under 100 characters, and reviewRating.ratingValue. An aggregate rating needs ratingValue plus reviewCount or ratingCount. The default scale is 1 to 5. Set bestRating and worstRating if you use another scale.

Why was my reviewer name rejected?

Google requires a real name. A promotion such as “50% off until Saturday” is not an author. Names of 100 characters or more are not eligible. This tool drops those names and warns you.

Does a rating in the code have to match the page?

Yes. The stars, the count, and the review text in the markup have to be visible. Do not invent a count or round an average up.

More free tools

See all tools