SEO Guide · 2026

Shopify Review Schema for AI Shopping Agents

Q: Can I manually add AggregateRating JSON-LD to my Shopify theme?

Technically yes, but the values would be static — hardcoded rating and count that go stale immediately. AI agents and Google's crawlers verify review schema against the visible HTML on the page. If your JSON-LD says 4.8/127 but your page HTML shows different numbers, the schema may be flagged as misleading and ignored.

Star ratings visible to human shoppers don't exist for AI shopping agents. What exists is AggregateRating JSON-LD — structured review data embedded in your product pages. If your review app renders HTML stars but doesn't inject JSON-LD, your products show zero review signal to ChatGPT Shopping, Perplexity Shopping, and Google AI Mode.

TL;DR Shopify's native Product Reviews app does not emit AggregateRating JSON-LD. Apps confirmed to emit it (as of mid-2026): Okendo, Judge.me (Awesome plan), Yotpo (Growth+), Loox, Fera. Verify yours with curl -s https://yourstore.com/products/[handle] | grep -i aggregaterating.

Why HTML stars are invisible to AI agents

When AI shopping agents crawl a Shopify product page, they parse the <head> JSON-LD blocks — specifically the structured data embedded in <script type="application/ld+json"> tags. They do not parse HTML rendered star widgets, CSS-based rating icons, or JavaScript-injected review carousels.

A store running Shopify's built-in Product Reviews app may display "4.8 ★ (127 reviews)" prominently on every PDP — and still receive zero review signal credit from any AI shopping agent. The visible UI is irrelevant; only the JSON-LD matters.

The required JSON-LD structure is an AggregateRating block nested inside your Product JSON-LD:

"aggregateRating": {
  "@type": "AggregateRating",
  "ratingValue": "4.8",
  "reviewCount": "127",
  "bestRating": "5",
  "worstRating": "1"
}

This block must be dynamically populated by your review app — a static hardcoded value that doesn't update with new reviews will quickly diverge from the HTML display and may be flagged as misleading by Google's structured data evaluators.

Review app comparison: which emit AggregateRating JSON-LD

App	JSON-LD emitted?	Plan required	Approx. monthly cost
Shopify Product Reviews (native)	No	Free	$0
Judge.me	Awesome plan only	Awesome ($15/mo)	$15
Okendo	Yes (all plans)	Essential ($19/mo)	$19+
Yotpo	Growth plan+	Growth ($15/mo)	$15+
Loox	Yes (all plans)	Beginner ($9.99/mo)	$9.99+
Fera	Yes (all plans)	Startup ($9/mo)	$9+
Ali Reviews	No	Any	varies
Rivyo	No	Any	varies

Prices as of mid-2026. Verify current plan features with each provider's documentation before switching — plan structures change. The key question to ask any review app: "Does your app inject AggregateRating JSON-LD into the <head> of every product page?"

How to verify your review schema is working

The fastest verification method is a raw HTTP fetch that mimics how AI bots crawl your pages — avoiding JavaScript rendering and Cloudflare bot challenges:

curl -s -A "Googlebot/2.1 (+http://www.google.com/bot.html)" \
  https://yourstore.com/products/your-product-handle \
  | grep -i "aggregaterating"

If this returns nothing, your review app is either not emitting JSON-LD or is injecting it via JavaScript (client-side), which means AI agents that don't execute JS won't see it. The fix is to configure your review app to inject AggregateRating server-side — most apps have a "structured data" or "SEO" toggle in their settings that enables server-side JSON-LD injection.

Cloudflare and bot-blocked review schema

A common scenario: your review app emits correct JSON-LD, but Cloudflare's bot protection blocks the curl fetch above, returning a 403 or JS challenge page. AI agents facing the same challenge never reach your product pages. See the Cloudflare AI crawler guide for how to whitelist GPTBot, PerplexityBot, and ClaudeBot while keeping security rules active for human scraping.

AggregateRating field completeness

Several stores use review apps that emit AggregateRating JSON-LD but with incomplete or invalid fields. The most common issues:

Missing bestRating / worstRating — Required for Google Rich Results. Without them, your stars may not display in SERP even if the rating value is correct.
reviewCount vs. ratingCount — Use reviewCount (number of written reviews). ratingCount (number of ratings without written review) is less trusted by Google AI Mode.
String vs. number types — "ratingValue": 4.8 (number) and "ratingValue": "4.8" (string) are both valid Schema.org. Use string to avoid floating-point precision issues in JSON serialization.
Stale hardcoded values — If a theme edit or app migration left static AggregateRating JSON-LD in your template, it will diverge from the real review count and may trigger a "misleading markup" manual action from Google.

FAQ

Does Shopify's built-in Product Reviews app emit AggregateRating JSON-LD?

No. Shopify's native Product Reviews app (free) renders star ratings and review text in HTML only — it does not inject AggregateRating JSON-LD into product pages as of mid-2026. AI shopping agents receive no review signal from stores using only the native app.

What's the minimum reviewCount for AggregateRating to affect AI agent ranking?

Google Shopping and Google AI Mode require at least 3 reviews before displaying rating stars in rich results. Perplexity Shopping uses review signal regardless of count, but weights it logarithmically — going from 1 to 10 reviews matters more than going from 100 to 1,000. Focus on collecting your first 10 reviews rather than worrying about scale initially.

Can I manually add AggregateRating JSON-LD to my Shopify theme?

Technically yes, but static values go stale immediately. AI agents and Google's crawlers verify review schema against the visible HTML on the page. If your JSON-LD says 4.8/127 but your page HTML shows different numbers (or zero), the schema may be flagged as misleading and ignored or penalized. Use a review app that dynamically populates the values instead.

Which Shopify review apps emit AggregateRating JSON-LD?

Confirmed as of mid-2026: Okendo (all plans), Judge.me (Awesome plan, not the free plan), Yotpo (Growth plan and above), Loox (all plans), Fera (all plans). HTML-only with no JSON-LD: Shopify native Product Reviews, Ali Reviews, Rivyo. Always verify with a raw curl fetch after installing any review app.

Check your review schema coverage

2-minute scan. CatalogScan verifies AggregateRating JSON-LD is present, dynamic, and correctly populated across your catalog.

Run the free scan →