How to fix invalid rating value on Adobe Commerce (Magento)

Fix the AggregateRating.ratingValue in your structured data so it is a valid number between 1 and 5 (or your declared scale's minimum and maximum).

Steps for Adobe Commerce (Magento)

  1. AggregateRating structured data in Adobe Commerce / Magento is typically output from the product view template or a dedicated structured data module.
  2. Check app/design/frontend/<Vendor>/<Theme>/Magento_Catalog/templates/product/view/ or the equivalent in the active theme for any structured data template file (often schema.phtml or structured_data.phtml).
  3. If using a third-party SEO extension (Mageplaza SEO, Amasty SEO, etc.), navigate to that extension's configuration in Stores → Configuration → [Extension] → Rich Snippets / Structured Data and confirm ratingValue is mapped to the product's actual average rating attribute, not a default of 0.
  4. In custom code, replace any hardcoded ratingValue with a call to $product->getRatingSummary() or the review model's getReviewsCount() / getRatingSummary() methods, and wrap the block in a conditional that checks review count > 0.
  5. Run bin/magento cache:clean and bin/magento setup:di:compile after making template or module changes.
  6. Validate with the Google Rich Results Test on a product URL that has real reviews.
Official Adobe Commerce (Magento) documentation ↗

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.

Not sure if your Adobe Commerce (Magento) store has this?

Run a free SEOLZ scan — we’ll find invalid rating value and every other issue across your whole site.

Scan my site free

Fix invalid rating value on another platform