How to fix invalid rating value on Shopify Plus

Steps for Shopify Plus

1. Follow the same steps as Shopify above.
2. For enterprise stores using a custom storefront (Hydrogen/Headless), locate the JSON-LD component in your React/Next.js codebase and apply the same ratingValue bounds fix there.
3. If using a third-party review platform (Yotpo, Okendo, etc.) at scale, coordinate with the platform's enterprise support to ensure schema output is valid before re-deploying.

{
  "@context": "https://schema.org",
  "@type": "Product",
  "name": "Example Product",
  "aggregateRating": {
    "@type": "AggregateRating",
    "ratingValue": "4.3",
    "reviewCount": "28",
    "worstRating": "1",
    "bestRating": "5"
  }
}

What is invalid rating value?

Structured data is hidden code on your product and review pages that tells Google exactly what your content means — things like star ratings, prices, and product names. The `AggregateRating` block inside that code includes a `ratingValue` field (the average star score) and should also declare `bestRating` and `worstRating` to define the scale. Google requires `ratingValue` to be a real number that sits between `worstRating` and `bestRating`. A value like "0.5" on a 1–5 scale, or any value outside the declared bounds, is treated as invalid and disqualifies the entire rating from appearing in search results.

Star ratings displayed directly in Google search results (called Rich Results or Review Snippets) dramatically increase click-through rates — shoppers trust and click on listings with visible stars far more than plain blue links. An invalid `ratingValue` causes Google to silently drop the star display from your listing entirely, costing you that visibility advantage. Over time, losing those stars means lower organic traffic and fewer first-click conversions compared to competitors whose ratings show correctly. There is also an accuracy obligation: Google's guidelines explicitly require that rating values reflect real customer ratings and fall within a valid numerical range — violations can result in manual actions against your structured data.

See the complete Invalid rating value guide for every platform and the full background.