Academy

Structured Product Data for Agentic Commerce

Build an agentic product data page with identifiers, price, availability, shipping, returns, and complete schema that shopping agents can transact from.

15 min read

Agentic product data page

Purpose: give an AI shopping agent enough exact, current, machine-readable information to identify an item, evaluate an offer, calculate whether it can be delivered, explain the return risk, and hand off or complete a transaction without guessing.

Primary question: “Can I buy this exact product for this customer, at this price, in this place, under these delivery and return terms?”

An agentic product data page is a stable public representation of one product or variant family built for both inspection and action. Unlike a conventional product page , which can rely on visual hierarchy and persuasive context, this type treats identity, offer, availability, shipping, and returns as explicit fields with scope. The two formats should normally coexist at one canonical URL: people get explanation and evidence; agents get the same facts in visible text, structured markup, and dependable commerce interfaces.

Questions it answers

The page must let a shopping agent answer all of these without inferring a missing value:

  • What exact product and variant does this record describe?
  • Which merchant SKU, global identifier, brand, model, size, color, capacity, and condition identify it?
  • What is the current price, currency, unit, tax treatment, and valid offer period?
  • Is the selected variant actually available, backordered, preorderable, or discontinued?
  • Can it ship to the customer’s destination, at what cost, through which method, and within what delivery window?
  • Who sells and fulfills it, and where does responsibility transfer?
  • What can be returned, within how many days, by which method, at whose cost, and with what exceptions?
  • What action is valid now: buy, reserve, request a quote, join a waitlist, or choose another offer?

The page is ready for agentic use only when absence is explicit. “Shipping not stated” is different from free shipping; “availability unknown” is different from in stock.

When to use this post type

Use it when a product can be selected or transacted and an automated client needs more than a marketing description. It is especially valuable where variants, sellers, destinations, or policy exceptions make the answer conditional.

Confusable siblingUse that sibling whenWhy this type is different
product pageA human buyer needs fit, benefits, evidence, media, reviews, and a purchase decision for one product.Agentic product data focuses on exact transaction fields and their machine-readable agreement. In practice, one URL should satisfy both specifications.
category pageThe reader or agent must discover and narrow a set before choosing an exact item.A category can expose filters and range-level guidance, but it cannot substitute for variant-level identifiers, stock, delivery, and returns.
documentation articleAn existing user needs behavior, settings, compatibility, or instructions after acquisition.Documentation explains use; agentic product data establishes whether a specific offer can be transacted.
LLMs.txt pageA publisher wants to point AI systems toward authoritative resources.LLMs.txt is guidance, not a catalog, offer feed, stock source, shipping calculator, or transaction contract.

Do not create a separate indexable “AI version” that repeats the human page. Duplication creates competing canonicals and two places for volatile facts to drift. Use a separate representation only when content negotiation, a documented endpoint, or a non-indexable data response serves a real client requirement.

Logo

Ready to Monitor Your AI Visibility?

Track how AI chatbots mention your brand across ChatGPT, Perplexity, and other platforms.

Best for these business types

  1. Ecommerce . The strongest fit because price, variant, inventory, shipping, and returns already exist in operational systems. The task is to expose them with the same identifiers and scope used at checkout.
  2. Marketplaces . Essential when one product has several sellers or conditions. Product identity must remain separate from offer identity so an agent does not attach one seller’s price to another seller’s delivery or return terms.
  3. Manufacturers and industrial businesses . Valuable for model numbers, technical compatibility, pack quantities, regional distributors, lead times, and quote-based availability. “Contact us” should still expose what can be quoted and which facts vary.
  4. SaaS . Useful when a plan, add-on, seat bundle, or usage package is genuinely purchasable. Replace physical shipping fields with activation timing and regional or account eligibility, while keeping price basis, renewal, cancellation, and seller identity explicit.

Search intent

Intent sits at the decision and transaction boundary. Queries combine a known product or model with “price,” “in stock,” “delivery to,” “returns,” a size or color, or a buying instruction. An AI prompt may add constraints in one sentence: “Find the black 256 GB model under €900, delivered to Bratislava next week, with at least a 30-day return window.”

The correct answer is not a general recommendation. It is a constraint-preserving offer: exact variant, exact seller, current total, destination eligibility, delivery estimate, return conditions, and a stable action. If one condition cannot be verified, the response must identify the gap instead of silently relaxing it.

Page structure

Word bands keep explanation proportionate. Most critical content is field data, not prose, and must be generated from governed sources rather than copied into editorial text.

SectionWord or data bandPurposeRequired?
Hero and direct answer50–90 words plus fieldsName the exact product, selected variant, seller, price, availability, and valid action.Required
Identity record8–20 fieldsBind SKU, global identifiers, brand, model, variant attributes, condition, and canonical URL.Required
Offer and price8–18 fieldsState amount, currency, unit, tax scope, seller, validity, quantity limits, and offer URL.Required
Availability5–12 fieldsState stock status, variant scope, quantity boundary, preorder or backorder state, and verification time.Required
Shipping8–20 fields per market or methodDefine destination, rate, threshold, handling time, transit window, carrier or method, and restrictions.Required for deliverable products
Returns and warranty8–18 fieldsDefine window, method, fees, condition, category exceptions, refund timing, and policy URL.Required
Product specifications10–40 rowsExpose dimensions, composition, compatibility, included items, and constraints with units.Required when relevant to selection
Evidence and provenance60–140 words plus timestampsIdentify source systems, verification time, seller ownership, and policy scope.Required
FAQ and action250–450 wordsResolve residual agent and buyer questions, then expose one truthful next action.Required

Required elements

Position follows dependency: an offer cannot be evaluated until identity is stable, and a delivery promise cannot be evaluated until offer and destination scope are known.

ElementAlways or conditionalPosition
direct answer blockAlwaysFirst content beneath the product name; include exact variant, seller, price, availability, and action.
spec tableAlwaysIdentity fields first, then product attributes; every value includes unit and variant scope where applicable.
price tableAlways for more than one offer, tier, or quantity ruleAfter identity and before availability; keep seller, currency, tax basis, and validity in the same row as amount.
availability blockAlwaysBeside the selected offer and before the transaction action; never display parent-product stock for a selected variant.
disclaimerConditionalImmediately beside a material condition such as estimated tax, quote-only freight, subscription renewal, or geographic exclusion.
freshness stampAlwaysBeside volatile offer fields; identify what was checked and when, not merely when the page was edited.
FAQ structureAlways, five or more questionsAfter policies and before the final action; visible answers must match FAQ data exactly.
CTA blockAlwaysLast decision block; use buy, reserve, request quote, join waitlist, or select another variant according to live state.

Frontmatter

Follow the frontmatter specification . On this specification page, use entity = "post-type-agentic-product-data" and schemaTypes = [ "Article", "FAQPage" ] because the page explains a post type rather than selling the fictional example.

On a produced commerce page, entity must identify the stable product, such as northstar-travel-charger-65w, while SKU and global identifiers identify sellable variants. Use Product for the product and Offer for one seller’s purchasable offer; use AggregateOffer only when the visible page truly summarizes several offers. Add applicable shipping and merchant return-policy properties. A product page containing visible FAQ content may also qualify for FAQPage, subject to current search-engine rules, but FAQ markup is not a substitute for Product and Offer data.

The source of truth should also govern feeds, APIs, and checkout. Required operational fields include currency, market, seller, fulfillment owner, selected SKU, price validity, availability timestamp, shipping destination scope, return-policy scope, canonical URL, and data owner. Schema completeness means required decision fields are both populated and correct—not that every possible property appears.

Full example

This fictional page demonstrates the minimum transaction contract. Its values are examples, not claims about a real merchant.

# Northstar 65 W travel charger — EU, black

The Northstar 65 W travel charger, SKU NS-65-EU-BLK and GTIN 09506000134352, is sold new by Northstar Direct for €49.00 including VAT. This EU black variant is in stock. Standard delivery to Slovakia costs €4.90 and is estimated for 1–3 September 2026 when ordered before 14:00 CEST on 27 August.

## Product identity

| Field | Value |
|---|---|
| Brand | Northstar |
| Model | Travel Charger 65 W |
| Merchant SKU | NS-65-EU-BLK |
| GTIN-14 | 09506000134352 |
| Variant | EU plug, black |
| Condition | New |
| Included | Charger and 1 m USB-C cable |

## Offer

| Seller | Price | Currency | Tax | Availability | Valid through |
|---|---:|---|---|---|---|
| Northstar Direct | 49.00 | EUR | VAT included | In stock | 31 August 2026, 23:59 CEST |

Price applies to one NS-65-EU-BLK unit. Maximum online quantity is four per order. The seller and fulfillment provider are Northstar Direct.

## Shipping to Slovakia

| Method | Cost | Handling | Transit | Estimated delivery |
|---|---:|---|---|---|
| Standard tracked | €4.90 | Same business day before 14:00 CEST | 2–4 business days | 1–3 September 2026 |
| Express tracked | €12.90 | Same business day before 14:00 CEST | 1–2 business days | 31 August–1 September 2026 |

Lithium batteries are not included. Delivery estimates exclude address corrections and carrier disruptions. Recalculate shipping after the destination or cart quantity changes.

## Returns and warranty

Unused products may be returned within 30 calendar days of delivery through the online return form. The customer pays return postage unless the product is faulty or incorrect. Opened packaging is accepted when the charger, cable, and documentation are complete and undamaged. Refunds return to the original payment method after inspection. A two-year limited warranty covers manufacturing defects but not accidental or liquid damage.

## Transaction state

Verified against catalog, inventory, shipping, and returns systems at 10:00 CEST on 27 August 2026. Revalidate price, stock, destination eligibility, delivery estimate, and return scope immediately before checkout.

[Buy the EU black variant]

The example keeps price and validity together, separates handling from transit, names the return payer, and scopes every volatile claim. A human can read it; an agent can map it to fields without interpreting a promotional phrase.

Use the same product, variant, seller, destination, and timestamp in every design so review tests data comprehension rather than different examples.

Quality checklist

  • One canonical product identity is separated from SKU-level variants and seller-level offers.
  • SKU, GTIN, ISBN, or manufacturer part number values belong to the exact variant; no identifier is inferred or fabricated.
  • Product name, brand, model, condition, selected attributes, and canonical URL agree in visible content, schema, feed, and checkout.
  • Price includes currency, unit or billing basis, tax scope, seller, quantity rule, and validity where relevant.
  • Availability describes the selected SKU and seller, not the parent product or an adjacent warehouse record.
  • Shipping states destination scope, cost, threshold, handling time, transit time, estimated delivery, and restrictions without treating an estimate as a guarantee.
  • Returns state window, start event, accepted condition, method, fees, refund path, and product or regional exceptions.
  • Unknown values are identified as unknown; blank cells never imply free, included, or available.
  • Volatile facts come from operational systems and expose a meaningful verification time.
  • JavaScript-disabled and rendered responses both expose the critical identity and offer facts needed by intended clients.
  • Product and Offer markup matches visible content and uses the correct variant, seller, currency, and policy scope.
  • The purchase or handoff action preserves variant, offer, destination, quantity, and attribution.
  • Out-of-stock, preorder, quote-only, and discontinued states change both the message and the permitted action.
  • Automated tests detect mismatches among page, schema, feed, API, and checkout before a stale offer reaches an agent.
  • Human review checks exception wording, regulated claims, and unusual shipping or return cases that field validation cannot judge.

Common mistakes

Treating schema as hidden product copy. Structured data describes visible facts; it must not introduce a better price, different rating, broader availability, or return promise than the page shows.

Using a parent SKU for every variant. A blue medium garment and a black large garment are different sellable selections. Bind identifiers, price, image, stock, and action to the selected variant.

Publishing price without scope. “€49” is incomplete when tax, unit, subscription period, seller, minimum quantity, market, or expiry changes the amount.

Calling unknown shipping free. Shipping must be calculated or explicitly unavailable for the destination. A zero value is a commercial promise, not a placeholder.

Combining handling and transit. A two-day carrier service dispatched after five days is not two-day delivery. Store and show both intervals, then calculate an estimated date range.

Linking only to a generic returns page. The agent needs the applicable window and exceptions on the offer page, plus a stable policy URL for detail. Category exclusions must not be hidden behind the link.

Caching stock like editorial content. Inventory can change between crawl and checkout. Use suitable cache lifetimes, invalidation, timestamps, and mandatory revalidation before commitment.

Creating a second “AI product page.” Parallel indexable pages drift and split signals. Prefer one canonical human-and-machine source with alternate representations only for a documented technical need.

Making the CTA lie. An out-of-stock item cannot have an active “Buy now” action. Replace it with a stock alert, preorder, quote, or alternative that reflects the real state.

Internal linking

Link upward to the category page when an agent must choose among products, and sideways to the canonical product page specification when the production team needs human-facing evidence and persuasion rules. Link to a documentation article for setup, compatibility detail, care, or post-purchase use instead of crowding transaction fields with instructions.

Within the product record, keep links adjacent to the condition that creates the next question: the full return policy beside the summarized return rule, delivery restrictions beside shipping, and compatible accessories beside the relevant specification. Use an internal link module only for a small set of explained alternatives or supporting pages. Do not make an agent traverse several vague “learn more” links to reconstruct a transaction.

Every linked offer must preserve variant and seller context. Parameterized selections should resolve predictably, and canonical rules should prevent filter, currency, and destination states from multiplying into duplicate indexable URLs.

How to measure results

Measure reliable product resolution and transaction progression, not page traffic alone. Establish a baseline by market, device, client, product, variant, and seller where volume permits.

Track:

  • valid products and sellable variants with complete identifiers;
  • Product and Offer records passing technical validation and commercial reconciliation;
  • mismatches in price, currency, stock, seller, shipping, returns, and selected SKU across page, schema, feed, API, and checkout;
  • crawl or agent requests receiving usable critical data without script, consent, authentication, or timeout failure;
  • shopping answers and citations that preserve variant, seller, price, availability, destination, delivery, and policy conditions;
  • product-selection, add-to-cart, checkout-start, quote, reservation, and completed-order events attributed to the originating client or handoff;
  • failed handoffs caused by stale stock, changed price, unsupported destination, invalid variant, expired session, or policy disagreement;
  • cancellations, returns, and customer-service contacts caused by a fact the agent presented incorrectly or omitted;
  • time from source-system change to corrected public representation.

Use AI Accessibility and Agent Readiness to test whether automated clients can reach and interpret the commerce surface. Open the AmICited Cockpit to compare visibility, cited sources, landing activity, and commercial outcomes over the same observation window.

Follow how we measure results to separate discovery, correct representation, engagement, transaction progress, and revenue. Annotate catalog migrations, pricing campaigns, stock events, policy changes, and protocol releases before attributing movement. A cited product answer is not a success if its offer cannot survive checkout validation.

FAQ

Frequently asked questions

Is an agentic product data page separate from the human product page?
Not necessarily. The preferred implementation is usually one canonical product URL whose visible facts, structured data, feeds, and commerce endpoints agree. A separate machine-readable page is justified only when it adds a stable representation without creating a competing indexable product page.
Which product identifiers should be published?
Publish the merchant SKU and every valid global identifier available for the exact variant, such as GTIN, ISBN, or manufacturer part number, together with brand and model. Never invent a global identifier or copy one from a similar variant.
Which schema types are required for agentic commerce?
Use Product for the item and Offer or AggregateOffer for purchasable offers, with applicable shipping and return-policy properties. Schema must match visible content and the selected variant; completeness and consistency matter more than adding unrelated types.
How current must price and availability data be?
Current enough that an agent does not present an expired price or attempt an impossible purchase. Generate volatile fields from the commerce source of truth, invalidate caches after material changes, expose a verification time, and monitor mismatches.
Can JavaScript supply the product facts?
It can, but critical identity, offer, shipping, and return facts should also be available in the initial or reliably rendered response. Test the page with the clients and crawlers that matter; do not assume every shopping agent executes the same scripts as a browser.
Should out-of-stock products remain accessible?
Usually yes when the product may return, still earns demand, or supports existing owners. Keep the stable identity and specifications, mark availability accurately, disable purchase, offer a stock alert or genuine substitute, and avoid claiming a delivery date.
See whether AI agents can transact from your product data
Audit the product identity, offer, availability, shipping, returns, and access signals that automated shopping journeys depend on.

← All Academy tutorials

Ready to put it into practice?

Free check · 7-day trial · no credit card