How to fix invalid rating value on BigCommerce

Steps for BigCommerce

1. Go to Storefront > My Themes > current theme > Advanced > Edit Theme Files.
2. Search for 'ratingValue' in templates/components/products/ — typically in product-view.html or a structured-data partial.
3. Ensure the Handlebars expression outputs a value between 1 and 5, e.g. {{product.rating.average}}, and add '"worstRating": "1", "bestRating": "5"' to the same JSON-LD block.
4. If ratingValue could be 0 (no reviews yet), wrap the entire aggregateRating block in a conditional: {{#if product.rating.count}} … {{/if}} so it is omitted when there are no reviews.
5. Save and preview, then run the Rich Results Test.

{
  "@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.