Visible star ratings on product or review pages with no Review or AggregateRating schema are invisible to search engines. Google can display star ratings in SERPs only when structured data provides the numeric signal — the visual stars in your HTML mean nothing without it. schema-org AggregateRating and Review are among the highest-CTR Rich Result types; their absence is a direct revenue impact for e-commerce and service pages where purchase intent is highest. This is a frequent AI-generated gap: a review component is built, the visual stars ship, and the schema never follows.
Medium because missing review schema suppresses star Rich Results in SERPs, reducing CTR on high-intent pages, but does not break site functionality or expose user data.
Add AggregateRating or Review schema to every page that displays star ratings or reviews. In app/products/[slug]/page.tsx, derive the schema from the same computed aggregate your UI uses:
const schema = {
'@context': 'https://schema.org',
'@type': 'Product',
name: product.name,
aggregateRating: {
'@type': 'AggregateRating',
ratingValue: product.avgRating.toFixed(1),
reviewCount: product.reviewCount,
bestRating: '5',
worstRating: '1',
},
}
For individual reviews, use Review with author, reviewRating, and reviewBody — all three are required for Rich Results eligibility. Validate on the Google Rich Results Test.
ID: seo-advanced.structured-data.review-schema
Severity: medium
What to look for: Count all pages that display visible reviews, star ratings, or numeric ratings. For each page, check for Review or AggregateRating schema. Enumerate the required properties: author, ratingValue (numeric), bestRating, and reviewBody (for Review) or ratingCount and ratingValue (for AggregateRating).
Pass criteria: At least 90% of pages displaying visible reviews or ratings include Review or AggregateRating schema with at least 3 required properties present (author, ratingValue, and reviewBody for Review; or ratingValue, ratingCount, and bestRating for AggregateRating). Report: "X of Y review pages have complete schema."
Fail criteria: Fewer than 90% of review pages have schema, or schema is missing more than 1 required property.
Skip (N/A) when: The project has no user reviews or ratings displayed on any page.
Detail on fail: "2 of 5 product pages with star ratings lack AggregateRating schema" or "Review schema missing 'author' property on 3 pages".
Remediation: Review and rating schemas enable star ratings in search results. Add to product page components in app/products/[slug]/page.tsx:
{
"@context": "https://schema.org",
"@type": "Review",
"author": {
"@type": "Person",
"name": "Jane Reviewer"
},
"reviewRating": {
"@type": "Rating",
"ratingValue": "5",
"bestRating": "5",
"worstRating": "1"
},
"reviewBody": "Great product, highly recommend!",
"itemReviewed": {
"@type": "Product",
"name": "Product Name"
}
}