AggregateRating Schema Markup (JSON-LD Blueprint)
Structured data consolidating customer feedback scores, star averages, and total review counts for gold SERP star ratings.
Displayed below main page header or above the tool container. • Zero CLS Container
Production JSON-LD Code Block
Embed this structured data block directly into your HTML <head> or framework layout template.
{
"@context": "https://schema.org",
"@type": "Product",
"name": "Enterprise SEO Audit Suite",
"image": "https://omniseotools.com/images/products/audit-suite.jpg",
"aggregateRating": {
"@type": "AggregateRating",
"ratingValue": "4.9",
"reviewCount": "480",
"bestRating": "5",
"worstRating": "1"
}
}Typed Properties Specification (6 Fields)
Key Schema.org properties and sub-objects required to qualify for rich snippet treatment in Google Search.
| Property | Expected Type | Status | Description & Example |
|---|---|---|---|
| ratingValue | Number / Text | Required | Average calculated score (e.g. 4.9). e.g. 4.9 |
| reviewCount / ratingCount | Integer | Required | Total number of submitted customer evaluations. e.g. 480 |
| bestRating | Number / Text | Recommended | Highest possible score on scale (defaults to 5). e.g. 5 |
| worstRating | Number / Text | Recommended | Lowest possible score on scale (defaults to 1). e.g. 1 |
| itemReviewed | Thing | Required | The product, service, or organization entity being scored. e.g. { "@type": "Product", "name": "Enterprise SEO Suite" } |
| description | Text | Recommended | Explanation of rating methodology and verified review count. e.g. Aggregated score from 480 verified enterprise customer surveys. |
Google Search Console Pitfalls & Critical Warnings
Avoid these 3 common validation traps, parser errors, and algorithmic policy penalties when deploying AggregateRating schema.
Standalone AggregateRating Outside Parent Entity
Outputting AggregateRating as a root node without nesting it inside Product, Course, LocalBusiness, or SoftwareApplication.
Always nest aggregateRating inside a valid parent entity.
Using AggregateRating on Plain Editorial Articles
Google explicitly prohibits review star ratings on standard Article, TechArticle, or BlogPosting schemas.
Restrict aggregate ratings to eligible types (Product, LocalBusiness, Recipe, Course, Software).
Zero or Negative reviewCount
Declaring ratingValue '5.0' with reviewCount '0'.
Ensure reviewCount > 0 based on real reviews.
Recommended Implementation Scenarios
Related Schema Blueprints
Explore complementary structured data blueprints across the Technical SEO cluster.
Displayed below main page header or above the tool container. • Zero CLS Container