Skip to main content
Critical Reviews

AggregateRating: Making Your Reviews AI-Readable

Updated Recently updated
#aggregate-rating#reviews#schema-org
Share
This article includes a quiz, test your knowledge at the end! Jump to quiz

The invisible reviews problem

Verity Score verifies that your customer reviews are machine-readable. Specifically, we check for an AggregateRating schema in the HTML source of your product pages.

Why it matters for AI

Customer reviews are one of the most powerful trust signals for AI shopping agents. A product with 342 reviews and a 4.7/5 rating will be recommended before a product with no reviews.

Research from Yale University, Columbia University, and the University of Chicago shows that AI agents are 20–40% less likely to select products when sentiment data and review volume are missing. Without AggregateRating in the HTML, you’re effectively invisible to this growing share of the buying journey.

But here’s the catch: most Shopify review apps load reviews via JavaScript. The widget displays beautiful stars for human users, but the HTML source contains nothing. AI crawlers (GPTBot, PerplexityBot, ClaudeBot) don’t execute JavaScript - they only read the initial server-rendered HTML.

The Simple Test

  1. Go to a product page on your store
  2. Right-click β†’ β€œView page source”
  3. Ctrl+F β†’ search for AggregateRating or ratingValue
  4. If you find nothing, your reviews are invisible to AI

The Key Point: HTML vs JavaScript

Comparison of native HTML vs JavaScript: reviews in JSON-LD are visible to AI crawlers (GPTBot, PerplexityBot), while JavaScript-loaded reviews are invisible
Figure 1 - Native HTML vs JavaScript: why your reviews are invisible to AI

The fundamental question is simple: are your reviews in the HTML source or loaded via JavaScript?

A widget that displays beautiful stars but whose data is not in the HTML source is invisible to AI agents. This is the most common problem on Shopify stores.

Verity Score automatically detects whether your AggregateRating is present in the HTML and whether the values are consistent with what is displayed visually.

Review Apps and Schema.org

AppNative AggregateRatingSetup Required
Judge.meYesEnabled by default
Stamped.ioYesEnable in SEO settings
LooxYesEnable JSON-LD in settings
BazaarvoiceYesEnable the Authentic Discovery API - injects reviews as server-side JSON-LD (SSR), no JavaScript dependency
YotpoPartialCheck SEO snippet settings

Common Mistakes

  1. Widget visible but schema absent : Stars display but JSON-LD not enabled
  2. ratingValue out of range : 47 instead of 4.7
  3. reviewCount at 0 : Inconsistent with having a rating value


Ready to check your store? Run a free GEO audit β†’

Frequently Asked Questions

Why are my Shopify reviews not showing in Google search results?
Most Shopify review apps load reviews via JavaScript, which Google and AI crawlers can't read. You need to enable the JSON-LD or AggregateRating schema option in your review app settings so ratings appear in the HTML source.
How do I add AggregateRating schema to my Shopify store?
The easiest way is through your review app's settings. Apps like Judge.me, Stamped.io, and Loox have built-in options to inject AggregateRating into your product page JSON-LD. Enable the SEO snippet or schema setting.
What is the difference between star ratings on the page and AggregateRating in schema?
Star ratings on the page are visual elements for human visitors. AggregateRating in schema.org is structured data in the HTML source that search engines and AI can read. You need both: the visual widget and the schema markup.
Can AI shopping agents see my customer reviews?
Only if your reviews are in the HTML source as AggregateRating schema. AI crawlers don't execute JavaScript, so widget-only reviews are completely invisible to them. Check your page source for 'ratingValue' to verify.
🧠 Test your knowledge
1 / 5