Shopify AggregateRating schema

AggregateRating is the most-failed signal across every Shopify store CatalogScan has ever scanned: roughly 9 in 10 of the launch-scan stores were missing it entirely, even when they had Yotpo, Judge.me, Loox, Stamped, or Okendo installed and showing a star widget on every PDP. The visible stars on the page and the schema-readable stars in the JSON-LD are two different things — and AI shopping agents only see the second one. This is the dial to flip first; it's free, fast, and almost always one toggle inside your existing reviews app.

Last updated 2026-04-30 · Ranking-spread signal · 10 pts · Highest failure rate of any signal

What it is

AggregateRating is the schema.org vocabulary node that summarizes all customer reviews of a single product into two numbers: the average rating and the count. It's the structured-data equivalent of "★ 4.7 (3,284)" that you display on the page. The required shape, inline on a Product:

{
  "@context": "https://schema.org",
  "@type": "Product",
  "name": "Wool Runner",
  ...
  "aggregateRating": {
    "@type": "AggregateRating",
    "ratingValue": "4.7",
    "reviewCount": "3284",
    "bestRating": "5",
    "worstRating": "1"
  }
}

The bestRating and worstRating fields are optional but recommended — without them, agents assume a 1–5 scale by convention, but explicit is better than implicit. reviewCount must be an integer; some apps emit "3284 reviews" as a string, which trips strict parsers.

Why AI shopping agents care

This is the tie-breaker signal. When two stores sell the same-or-similar product and both clear every other signal, the one with parseable AggregateRating wins. Specifically:

• Confidence weighting. A 4.7 / 3,200-review product carries more confidence than a 4.9 / 12-review product for an agent ranking results. But agents can only weight what they can read — no aggregateRating node, no input.
• Review-count threshold. Some agents won't surface a product without a minimum review count (varies by query type — e.g., "best running shoes" filters more aggressively than "where to buy Allbirds"). A 4.9-rated, 850-review product without aggregateRating in JSON-LD is invisible to that filter.
• Rich-card rendering. When ChatGPT Shopping cites your product in a response, the star rating in the rich card comes from this field. Missing aggregateRating = star line disappears = lower click-through.

How to test it on your store

The visible-star widget on your PDP and the schema-readable AggregateRating in JSON-LD are two completely separate things. Most stores have the first and not the second. To check the second:

1. Open any PDP, view source.
2. Search for aggregateRating (case-sensitive). It should appear inside a <script type="application/ld+json"> block whose top-level @type is Product.
3. If you find it: confirm both ratingValue and reviewCount are present, non-zero, and parseable.
4. If you don't find it: your reviews app is rendering stars on the page but not injecting structured data. The fix is below.

For a faster overview across all your PDPs, run the free CatalogScan scan — it'll report aggregateRating presence on the sampled product and tell you which review app you appear to have installed.

How to fix it

Almost every Shopify reviews app has a "rich snippets" / "schema injection" toggle, often shipped off by default. The exact path varies by app:

5 mistakes we keep finding