Shopify Schema Markup: What AI Agents Actually Read

What Shopify generates by default

Shopify's product.json_ld Liquid object outputs a Product schema block. On a typical Dawn-theme store, a product page includes something like this (simplified):

<script type="application/ld+json">
{
  "@context": "https://schema.org/",
  "@type": "Product",
  "name": "Merino Wool Crew Neck",
  "image": ["https://cdn.shopify.com/s/files/..."],
  "description": "Our softest sweater yet. Made from traceable merino wool.",
  "sku": "MW-CREW-S",
  "brand": {
    "@type": "Brand",
    "name": "Allbirds"
  },
  "offers": {
    "@type": "Offer",
    "url": "https://allbirds.com/products/merino-wool-crew-neck",
    "priceCurrency": "USD",
    "price": "98.00",
    "availability": "https://schema.org/InStock",
    "seller": { "@type": "Organization", "name": "Allbirds" }
  }
}
</script>

This is a valid Product schema. Google will accept it. But for AI shopping agents — which use structured data to generate comparison responses, cite specific product features, and resolve product identity across databases — this output is incomplete.

The fields AI agents prioritize

How to add the missing fields

aggregateRating — star ratings

If your Shopify store uses a reviews app (Okendo, Judge.me, Yotpo, Stamped, Product Reviews by Shopify), that app typically provides a Liquid snippet or theme block that outputs an aggregateRating block. Enable it in your theme settings. Here is what the output should look like:

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

If your reviews app does not provide a JSON-LD block, check its documentation for a "structured data" or "schema.org" setting. Most major Shopify review apps support this natively. See our aggregateRating signal guide for the exact theme edit.

gtin / gtin13 — product barcodes

Add your product barcodes in Shopify Admin → Products → (select product) → "Barcode (ISBN, UPC, GTIN)". Once populated, edit your theme's product JSON-LD Liquid snippet (typically in snippets/product-json-ld.liquid or inside sections/main-product.liquid) to include:

{% if product.selected_or_first_available_variant.barcode != blank %}
  "gtin": "{{ product.selected_or_first_available_variant.barcode }}",
{% endif %}

GTIN matters most for AI agents that cross-reference product identity across databases — if a user asks ChatGPT "is this the same product sold cheaper on Amazon?", the GTIN is how ChatGPT confirms it is the same physical item.

brand as a named entity

Shopify's default output uses {"@type":"Brand","name":"YourBrand"}. AI agents perform better entity resolution when the brand has a Wikidata or Google Knowledge Graph ID. If your brand has a Wikidata entry, add it:

"brand": {
  "@type": "Brand",
  "name": "Allbirds",
  "@id": "https://www.wikidata.org/wiki/Q63088386"
}

For brands without a Wikidata entry, a consistent brand URL ("url": "https://allbirds.com") helps AI systems resolve the entity.

Validating your schema markup

After making changes, verify with Google's Rich Results Test (search.google.com/test/rich-results) and Schema.org's validator (validator.schema.org). Both parse the JSON-LD on your product page and flag missing required fields or errors.

For bulk validation across your catalog — checking if every product page has the correct fields, not just one sample — use CatalogScan. The scan checks schema completeness across your product pages as part of its 13-signal audit.