How to fix invalid rating value on BigCommerce

Steps for BigCommerce

1. Go to Storefront → Themes → click 'Advanced' → 'Edit Theme Files' on your active theme (Stencil).
2. Search for 'ratingValue' inside templates/pages/product.html or the theme's schema.json / structured data partial.
3. Confirm the value references a Handlebars variable such as {{product.rating.average}} rather than a static 0. BigCommerce's native Stencil Handlebars context exposes product.rating.average and product.rating.count.
4. Add a conditional to suppress the AggregateRating block when there are no reviews: {{#if product.rating.count}} … {{/if}}.
5. If you use a third-party reviews app (PowerReviews, Yotpo, etc.), check whether that app injects its own structured data — disable any conflicting manual markup in the theme to avoid duplicate or zeroed-out blocks.
6. Save and push the theme, then test a product URL in the Google Rich Results Test.

What is invalid rating value?

Structured data is hidden code on your product pages that tells search engines facts about your store — things like star ratings, prices, and product names. The `AggregateRating` block specifically communicates your average customer rating. The `ratingValue` field inside that block must be a real number (e.g. 4.3) that falls between the declared minimum and maximum rating values — typically 1 to 5. When it is missing, set to 0, left blank, or formatted incorrectly, search engines consider the entire rating block invalid.

A valid `AggregateRating` is what earns you gold star snippets in Google Search results — those eye-catching stars visible directly on the results page before a shopper even clicks. Stores with star snippets consistently see higher click-through rates, which drives more organic traffic and sales. An invalid or zero `ratingValue` means Google ignores your rating markup entirely, stripping those stars from your listing and handing the visual advantage to competitors. For Answer Engine Optimisation (AEO), valid rating structured data also influences how AI-powered answer engines and shopping assistants surface and rank your products in direct answers.

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