Review & AggregateRating Schema Generator

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

Item type

Name of the item / product

Image URL (optional)

Reviewer name

Rating (1–5)

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

Review text (optional)

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.