SchemaValid
ENDE

Review & Aggregate Rating Schema Generator

Create valid Review or Aggregate Rating JSON-LD structured data for products, software, books and more — instantly, in your browser, free of charge.

Try an example

Review details

1 to 5, decimals allowed for averages. Best rating is fixed at 5.

JSON-LD code

Fill in the required fields to generate the JSON-LD code.

Important note on Google's Self-Serving guidelines: Google no longer displays review stars for businesses reviewing themselves on their own websites (LocalBusiness or Organization). Stars are now only shown for specific item types like Products, Software, Books, or Courses.

What is Review and AggregateRating schema?

Both are structured data types from schema.org that describe ratings. A Review represents a single review by one author, holding a reviewRating (the score), an author, and optionally the review text. An AggregateRating summarizes many ratings into one value plus a ratingCount (how many ratings it is based on). In JSON-LD, either one is embedded inside the item being rated — a Product, SoftwareApplication, Book, Course, Event or Recipe — so search engines know what the rating applies to.

Google's Self-Serving update

Google no longer shows review stars in search results when a site rates itself — that is, when Review or AggregateRating markup is placed on a LocalBusiness or Organization on that same organization's own website ("self-serving" reviews). Stars are only rendered for a defined set of reviewable item types: Product, SoftwareApplication, Book, Course, Event, Recipe and a few others. This tool deliberately offers only those eligible types, so the markup you generate can actually qualify for star display.

How to add the schema to your site

Copy the generated code and paste it into a script tag of type application/ld+json, placed in the head section of the page that shows the item and its rating. The rating and review content must also be visible to users on that page — the markup describes existing content, it does not replace it. A minimal example looks like this:

<script type="application/ld+json">
{
  "@context": "https://schema.org",
  "@type": "Product",
  "name": "Executive Anvil",
  "aggregateRating": {
    "@type": "AggregateRating",
    "ratingValue": 4.4,
    "ratingCount": 89,
    "bestRating": 5
  }
}
</script>

Frequently asked questions

What is the difference between Review and AggregateRating?
A Review is a single review from one person, with an author and a score. An AggregateRating combines many individual ratings into one average value plus a count. Use a Review for one testimonial, and an AggregateRating to summarize all ratings an item has received.
Why can't I pick LocalBusiness or Organization here?
Google no longer shows review stars for self-serving markup, where a business rates itself on its own site via LocalBusiness or Organization. This tool only offers item types that are still eligible for star display, so the code you get can actually work.
Which item types are eligible for review stars?
Google supports review snippets for a defined list including Product, SoftwareApplication, Book, Course, Event and Recipe. This generator covers those reviewable types.
Do the rating and review have to be visible on the page?
Yes. The rating, review text and author you mark up must also be shown as visible content on the same page. Structured data that describes content users cannot see is against Google's guidelines.
What value should bestRating have?
This tool fixes bestRating at 5, matching the common 5-star scale. Your ratingValue must fall between 1 and 5. Aggregate averages can be decimals, such as 4.4.
How do I check that my schema is valid?
Paste your page URL or the generated code into Google's Rich Results Test or the schema.org validator. They parse the JSON-LD and report whether the Review or AggregateRating structure is valid.
What is Review schema markup?
Review schema markup is a JSON-LD snippet based on the schema.org Review or AggregateRating type that describes a rating for an eligible item — attaching it to that item's structured data so Google can understand and potentially display it as a star rating.
Should I add Review schema to every page?
No — only add it to pages that actually display a specific, visible review or rating. Adding it to pages without real review content, like a homepage or a generic category page, doesn't match Google's guidelines and won't produce a meaningful result.
Can I include multiple individual reviews on one page?
Yes, schema.org supports an array of Review objects under the same item, each with its own author and score. This tool generates one review at a time; for several, you'd combine multiple review objects into a review array in the JSON-LD manually.
Can I use Review schema for services, not just physical products?
Yes. Beyond Product, the eligible types this tool offers — SoftwareApplication, Book, Course, Event and Recipe — already cover services and digital offerings, not just physical goods.
Can I show a star rating without any review text?
It's technically possible for an AggregateRating, but for a single Review it's best practice to include the review text — Google's guidelines expect a review to have genuine, visible written content behind the rating, not just a number.
Can Review schema be combined with Product schema on the same page?
Yes, and it's the recommended approach — nest the review or aggregateRating property inside the Product entity, or generate them separately and merge them into one JSON-LD block describing the same item.
What are common mistakes when adding Review schema?
The most frequent ones are marking up self-serving reviews on a LocalBusiness or Organization, using an item type Google doesn't support for stars, showing a rating that doesn't match what's visible on the page, and reusing the exact same review text across many different products.

Related tools