AggregateRating Schema

AggregateRating schema is the structured data that tells search engines the overall score a page has earned from many reviews — for example “4.6 out of 5 from 128 ratings.” When it's valid and backed by genuine, visible reviews, Google can show gold star ratings next to your result, which stand out in the listings and tend to lift click-through rate.

What is AggregateRating?

AggregateRating is a schema.org type that summarises multiple individual ratings into one score. It never stands alone — it's nested inside the thing being rated, most commonly a Product, but also LocalBusiness, Recipe, Event, Book, Course or SoftwareApplication. It's the aggregate counterpart to a single Review, which captures one person's rating.

Required and recommended properties

To be eligible for star rich results, your AggregateRating needs the following:

• ratingValue (required) — the average score, e.g. 4.6.
• ratingCount or reviewCount (one is required) — how many ratings/reviews the average is based on.
• bestRating (recommended) — the top of the scale; defaults to 5 if omitted.
• worstRating (recommended) — the bottom of the scale; defaults to 1.

Example: Product with AggregateRating

Here's how aggregateRating is nested inside a Product in JSON-LD:

<script type="application/ld+json">
{
  "@context": "https://schema.org",
  "@type": "Product",
  "name": "Wireless Noise-Cancelling Headphones",
  "aggregateRating": {
    "@type": "AggregateRating",
    "ratingValue": "4.6",
    "reviewCount": "128",
    "bestRating": "5",
    "worstRating": "1"
  }
}
</script>

Google's rules — ratings must be genuine

This is the part that gets sites penalised. Only add AggregateRating markup when the ratings are real, collected from your users, and actually visible on the same page. Do not invent an average, reuse the same rating across every page, or mark up ratings that live somewhere else. Self-serving or fabricated ratings violate Google's review snippet guidelines and can trigger a manual action that strips all your rich results. If you have no ratings yet, leave the markup out entirely.

How to generate AggregateRating markup

The quickest way is our Review schema generator or Product schema generator — both let you add a genuine aggregateRating and copy ready-to-paste JSON-LD. Fill in your real average and review count, then follow how to add schema markup to place the snippet on your page.

Validate before you publish

Paste your markup into our schema markup validator to confirm the required properties are present, then run it through Google's Rich Results Test to confirm star eligibility. New to structured data? Start with what is schema markup and the types of schema markup.