Resources / Structured data / Template
Review and AggregateRating JSON-LD Template
Describe attributable reviews and a supported rating summary for the exact item visitors can evaluate on the page.
What this describes
Use Review for an identifiable evaluation and AggregateRating for a summary calculated from multiple ratings. Attach both to the exact item being reviewed. The example uses a product; choose another supported item type only when the page and review actually concern that entity.
Copyable template
{
"@context": "https://schema.org",
"@type": "Product",
"@id": "https://www.example.com/products/example-product/#product",
"name": "Example Product",
"review": {
"@type": "Review",
"author": {
"@type": "Person",
"name": "Example Reviewer"
},
"datePublished": "2026-09-10",
"reviewBody": "The substantive review text shown on the page.",
"reviewRating": {
"@type": "Rating",
"ratingValue": 4,
"bestRating": 5,
"worstRating": 1
}
},
"aggregateRating": {
"@type": "AggregateRating",
"ratingValue": 4.4,
"bestRating": 5,
"worstRating": 1,
"ratingCount": 87,
"reviewCount": 24
}
}
Customize it
- Identify the reviewed item precisely and keep its name visible.
- Preserve the real scale; do not silently convert ratings to five stars.
- Use
ratingCountfor all ratings andreviewCountfor written reviews. - Keep the displayed summary synchronized with the underlying review system.
- Do not mark up ratings that users cannot find. For Google’s star review feature, a business’s own site is ineligible when it controls reviews about itself and marks up that
LocalBusinessor anotherOrganization, including through an embedded third-party widget. This restriction does not turn every product review into a self-serving review.
Validate it
Recalculate the aggregate from the source system, then use the live-page JSON-LD validation tutorial and Schema.org Validator. When targeting Google review snippets, also use the Rich Results Test and review current eligible item types and policy restrictions.
Official references
- Google Search Central: Review snippet structured data
- Schema.org: Review
- Schema.org: AggregateRating
Completion check
- Show the review and aggregate values visibly on the page.
- Preserve the author, scale, rating count, and reviewed item.
- Check feature-specific rules, including self-serving review restrictions.