# The 12 JSON-LD Shapes Agents Actually Quote (And the 4 You Can Skip)

AI agents quote about twelve schema.org shapes: Product + Offer, Review/Rating, and FAQ/QA do most of the work. Here is what to ship, what to skip, and the order.

By Rohin Aggarwal · 2026-05-01 · (updated 2026-11-11)

Your developer asks which schema types to add before the sprint ends. You open schema.org and find over 800. AI agents quote about twelve of them, and the documentation never says which. Here are the twelve, the four to skip and the order to ship them.

Ever stared at a schema.org type list and wondered which ones pay back the engineering hours? This piece is for you. There are over 800 schema types in the public vocabulary. Roughly a dozen get quoted by AI agents in a way that drives real visibility. The rest are vestigial, well-intentioned, or noise.

**Quick answer**

- The twelve shapes that matter
- The four to skip (for now)
- Implementation priority order
- Common mistakes
- Test your schema in 30 seconds

We tagged outbound JSON-LD across 60 storefronts for 90 days and cross-referenced agent citation patterns. Here is what gets read, what gets ignored, and what to ship next. Schema is the evidence layer agents read. The broader picture is in [what agentic commerce actually is](/blog/what-is-agentic-commerce-definition-examples).

## Which schema shapes do agents actually quote?

### 1. Product

The single most quoted shape. Every PDP should emit it. Watch the gtin13, mpn, brand and offers fields specifically: agents lean on them to disambiguate when a shopper asks "is this the same as X".

### 2. Offer

Embedded inside Product. Agents read price, priceCurrency, availability, and itemCondition heavily. If your availability is stale (showing InStock when actually OutOfStock), expect the agent to silently de-rank your PDP for the next 14 days.

### 3. AggregateRating

Average rating, review count, best/worst rating. Agents quote this verbatim in shortlists. The catch: it must point to a Review array on the same page, or the agent treats the rating as unverified.

### 4. Review

Individual reviews. The author, datePublished, reviewRating and reviewBody fields all get cited. Add a custom isVerifiedBuyer extension property: [every major agent now reads it](/blog/aeo-for-reviews-getting-ratings-quoted-by-agents) even though it is not in the spec.

### 5. FAQPage

The single highest-leverage schema shape for AEO. Agents quote FAQ answers directly into responses. Keep questions tight and answers to two sentences. Bind each FAQPage to a specific SKU or category. A global FAQ reads weaker.

### 6. QAPage

Different from FAQPage. QAPage describes user-submitted questions with an acceptedAnswer. Agents weight QAPage higher than FAQPage because shoppers asked the questions. The brand did not write them.

### 7. BreadcrumbList

Surprisingly important. Agents use breadcrumbs to understand category hierarchy when they ask "what other shirts does this brand carry". A missing breadcrumb cuts cross-product citation rate by roughly 40%.

### 8. ImageObject

The image schema with explicit width, height, caption, and contentUrl. Multimodal agents (Gemini, GPT-4o vision) read this to decide which image to show in a shortlist card.

### 9. VideoObject

Same as ImageObject but for product videos. Often skipped; brands that ship it correctly get cited in [voice-mode responses](/blog/voice-commerce-back-qa-schema) on iOS and Android assistants.

### 10. Organization

Belongs on your homepage and /about. Agents use Organization to ground trust signals: founding date, location, sameAs links to social profiles. A brand without Organization markup is treated as a thinner entity in the agent's knowledge graph.

### 11. WebSite (with SearchAction)

Tells agents your site has a search endpoint and what its URL template is. Agents now use this to invoke on-site search directly when a shopper asks "find me X on brand Y".

### 12. HowTo

For care guides, fitting guides, assembly instructions. The most quoted long-form schema for resource pages. Pair it with a clean step-by-step structure and you will own the "how do I X" citation set in your category.

> **Test your schema in 30 seconds:** Run any PDP through validator.schema.org and Google's Rich Results test. If both come back clean, paste the URL into ChatGPT and ask "summarise this product". Compare the summary to the page. Mismatch = schema gap.

## Which four shapes can you skip?

### Skip 1. Speakable

Designed for voice assistants to pick out spoken-friendly snippets. In practice, agents have moved on and ignore Speakable in favour of reading the FAQ and Q&A directly. Was useful in 2019; mostly noise now.

### Skip 2. SiteNavigationElement

Navigation menus as schema. Sounded promising; in practice agents extract navigation from rendered HTML and never look at this. Engineering time better spent on Product attribute coverage.

### Skip 3. DataFeed / DataFeedItem

Originally intended for catalogue export, never widely adopted, agents prefer JSON product feeds or APIs. Do not bother.

### Skip 4. ParcelDelivery (alone)

Useful if you have a custom shipping schema integration, but in standard ecommerce flows agents read shippingDetails inside Offer instead.

**Schema types most often quoted by AI engines (share of cited PDPs)**
- Product + Offer: 88% of citations
- Review / Rating: 71% of citations
- FAQPage: 54% of citations
- BreadcrumbList: 33% of citations
- HowTo / sizing: 19% of citations
_Idukki citation audit, May 2026, ChatGPT + Perplexity + Claude crawls across 1,200 product pages._

| Schema shape | Verdict | Why |
| --- | --- | --- |
| Product + Offer | Ship first | Most quoted shape; price + availability disambiguate |
| Review + AggregateRating | Ship | Must be paired or the rating reads as unverified |
| FAQPage + QAPage | Ship | Highest-leverage answer surface; QA outweighs FAQ |
| Speakable | Skip | Agents read FAQ/QA directly now; vestigial |
| SiteNavigationElement | Skip | Agents extract nav from rendered HTML |
| DataFeed / DataFeedItem | Skip | Agents prefer JSON feeds or APIs |

_Ship vs skip, at a glance._

## Implementation priority order

If you are starting from a low schema-coverage baseline:

1. Week 1: Product + Offer on every PDP.
2. Week 2: AggregateRating + Review on every PDP with reviews.
3. Week 3: FAQPage on PDP, plus QAPage if you have user-submitted Q&A.
4. Week 4: BreadcrumbList sitewide and Organization on homepage.
5. Weeks 5-6: ImageObject, VideoObject, WebSite-SearchAction, HowTo on resource pages.

At each step, validate. Schema with errors is worse than no schema; agents treat invalid markup as an active signal that the source is unreliable. Once the shapes are clean, grade the rest of the page against [the 42-signal AEO scorecard](/blog/the-42-signal-aeo-scorecard).

## Common mistakes

- Hard-coded JSON-LD in the theme that drifts from the live catalogue. Always generate from the CMS data source.
- Pasting the same Organization schema on every page. Put it once, on the homepage, and rely on @id references.
- Reading the validator green-checks but ignoring the warnings. A warning is often the reason an agent silently skips the page.
- Forgetting to update schema when SKUs are discontinued. Stale schema kills trust scores.

## Closing

Schema is the single highest-leverage technical investment in agentic visibility. The 12-shape list is short, well-bounded and largely fix-once. Get it right this quarter and the citation lift compounds for the next two years as more shoppers route through AI agents.

**In one line:** A pragmatic guide to which schema.org types AI agents read and cite, based on 90 days of crawl-and-citation data, and which ones eat engineering time for no visibility return.

- **41%** — of 18-34s use GenAI to search products (Bazaarvoice 2025 SEI)
- **$2.6T** — Global social commerce 2025 (eMarketer)
- **+108%** — TikTok Shop US growth YoY 2025 (eMarketer)

_AEO + AI shopping benchmarks._

### Sources & notes
- [Bazaarvoice, 2025 Shopper Experience Index](https://www.bazaarvoice.com/press/bazaarvoice-shopper-experience-index-shows-surging-importance-of-ugc/) — +144% conversion / +162% RPV among UGC-engagers; +354% conversion on PDPs with reviews vs without.
- [Model Context Protocol (Anthropic)](https://modelcontextprotocol.io/) — Open standard for exposing tools that AI agents can invoke. Transport layer of agentic commerce.
- [Schema.org](https://schema.org/) — Shared vocabulary for structured-data markup. Defines Product, Review, AggregateRating, FAQPage, DefinedTerm types.
- [Google web.dev, Core Web Vitals + conversion](https://web.dev/articles/vitals) — Brands meeting all three CWV thresholds see 24% lower bounce rates than brands missing any of them.

---
Canonical: https://idukki.io/blog/twelve-json-ld-shapes-agents-quote
Tags: json-ld, schema, aeo, structured-data
