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.
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 sibling | Use that sibling when | Why this type is different |
|---|---|---|
| product page | A 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 page | The 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 article | An 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 page | A 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.
Best for these business types
- 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.
- 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.
- 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.
- 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.
| Section | Word or data band | Purpose | Required? |
|---|---|---|---|
| Hero and direct answer | 50–90 words plus fields | Name the exact product, selected variant, seller, price, availability, and valid action. | Required |
| Identity record | 8–20 fields | Bind SKU, global identifiers, brand, model, variant attributes, condition, and canonical URL. | Required |
| Offer and price | 8–18 fields | State amount, currency, unit, tax scope, seller, validity, quantity limits, and offer URL. | Required |
| Availability | 5–12 fields | State stock status, variant scope, quantity boundary, preorder or backorder state, and verification time. | Required |
| Shipping | 8–20 fields per market or method | Define destination, rate, threshold, handling time, transit window, carrier or method, and restrictions. | Required for deliverable products |
| Returns and warranty | 8–18 fields | Define window, method, fees, condition, category exceptions, refund timing, and policy URL. | Required |
| Product specifications | 10–40 rows | Expose dimensions, composition, compatibility, included items, and constraints with units. | Required when relevant to selection |
| Evidence and provenance | 60–140 words plus timestamps | Identify source systems, verification time, seller ownership, and policy scope. | Required |
| FAQ and action | 250–450 words | Resolve 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.
| Element | Always or conditional | Position |
|---|---|---|
| direct answer block | Always | First content beneath the product name; include exact variant, seller, price, availability, and action. |
| spec table | Always | Identity fields first, then product attributes; every value includes unit and variant scope where applicable. |
| price table | Always for more than one offer, tier, or quantity rule | After identity and before availability; keep seller, currency, tax basis, and validity in the same row as amount. |
| availability block | Always | Beside the selected offer and before the transaction action; never display parent-product stock for a selected variant. |
| disclaimer | Conditional | Immediately beside a material condition such as estimated tax, quote-only freight, subscription renewal, or geographic exclusion. |
| freshness stamp | Always | Beside volatile offer fields; identify what was checked and when, not merely when the page was edited. |
| FAQ structure | Always, five or more questions | After policies and before the final action; visible answers must match FAQ data exactly. |
| CTA block | Always | Last 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.
Design gallery
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?
Which product identifiers should be published?
Which schema types are required for agentic commerce?
How current must price and availability data be?
Can JavaScript supply the product facts?
Should out-of-stock products remain accessible?
More tutorials in this section
Ready to put it into practice?
Free check · 7-day trial · no credit card