AIFDS 0.2 · beta

Ecommerce — Product Pages

Describe every fact an agent needs to answer purchase questions—materials, sizing, stock levels, delivery promises, and customer proof.

Schema: pdp.schema.json Industry overview: /industries/ecommerce/

Fields

Product documents should remove ambiguity for both customers and agents handling escalations.

Field Description
template String identifier; always ecommerce_product_page. Required.
version Semantic version number. Required.
updated_at ISO 8601 timestamp for the JSON snapshot. Required.
product Core metadata (id, sku, name, slug, url, category).
summary Short narrative plus bullet highlights to frame the value proposition.
media Array of images or video with type, src, alt, and optional position.
pricing Price, compare-at price, currency, discounts, and subscription notes where applicable.
inventory Stock status, quantity, backorder policy, and fulfillment estimates per region.
variants Array describing size, color, or other selection dimensions with their specific SKU and stock.
specifications Key-value pairs for materials, dimensions, care instructions, compatibility, etc.
policies Return window, warranty info, sustainability notes, and service commitments.
evidence Reviews, press quotes, certifications, or endorsements tied to the product.
actions Purchase, pre-order, restock notification, or support actions with context.
related_products Cross-sells or upsells with product_id, name, and url.
Example schema — handsomecalavera.com 
{
  "template": "ecommerce_product_page",
  "version": "1.0.0",
  "updated_at": "2024-02-22T11:45:00Z",
  "product": {
    "id": "HC-BAG-017",
    "sku": "HC-COMMUTER-SATCHEL",
    "name": "Calavera Commuter Satchel",
    "slug": "commuter-satchel",
    "url": "https://www.handsomecalavera.com/products/commuter-satchel",
    "category": ["bags", "everyday-carry"]
  },
  "summary": {
    "headline": "Slim leather satchel built for modern commute rhythms.",
    "subheadline": "Carries a 15\" laptop, notebook, and essentials in a weather-resistant shell.",
    "bullets": [
      "Vegetable-tanned full-grain leather from León, MX",
      "Magnetic closure with quick-access front pocket",
      "Removable cross-body strap and luggage pass-through"
    ]
  },
  "media": [
    {
      "type": "image",
      "src": "https://www.handsomecalavera.com/assets/products/commuter-satchel-front.jpg",
      "alt": "Calavera commuter satchel in chestnut leather",
      "position": 1
    },
    {
      "type": "image",
      "src": "https://www.handsomecalavera.com/assets/products/commuter-satchel-interior.jpg",
      "alt": "Interior pockets of commuter satchel",
      "position": 2
    }
  ],
  "pricing": {
    "currency": "USD",
    "amount": 325,
    "compare_at": 355,
    "discount": {
      "label": "Founder circle",
      "amount_off": 30,
      "expires_at": "2024-03-15T05:59:00Z"
    }
  },
  "inventory": {
    "status": "in_stock",
    "quantity": 142,
    "backorder_policy": "Made-to-order after stock depletes. Ship window 3 weeks.",
    "fulfillment": [
      { "region": "US", "estimate": "2-4 business days" },
      { "region": "EU", "estimate": "5-7 business days" }
    ]
  },
  "variants": [
    {
      "id": "HC-BAG-017-CHESTNUT",
      "options": { "color": "Chestnut" },
      "sku": "HC-CS-CHESTNUT",
      "inventory": { "status": "in_stock", "quantity": 62 }
    },
    {
      "id": "HC-BAG-017-ONYX",
      "options": { "color": "Onyx" },
      "sku": "HC-CS-ONYX",
      "inventory": { "status": "low_stock", "quantity": 18 }
    }
  ],
  "specifications": {
    "dimensions": "15.5\" W × 12\" H × 4\" D",
    "weight": "3.2 lbs",
    "materials": ["Full-grain leather", "Organic cotton lining"],
    "care": "Spot clean; apply conditioner every 6 months.",
    "fits": ["15\" laptop", "A4 notebook", "Tablet"]
  },
  "policies": {
    "warranty": "Lifetime stitching warranty and repair coverage.",
    "returns": "Free returns within 45 days.",
    "sustainability": "Leather sourced from audited tanneries; packaging recycled fiber."
  },
  "evidence": [
    {
      "type": "review",
      "source": "Verified buyer",
      "value": "4.9 / 5 from 318 reviews",
      "url": "https://www.handsomecalavera.com/products/commuter-satchel#reviews"
    },
    {
      "type": "press",
      "source": "Gear Patrol",
      "quote": "The Calavera Satchel is a daily driver built to age with you.",
      "url": "https://www.gearpatrol.com/style/a44123426/handsome-calavera-review/"
    }
  ],
  "actions": [
    {
      "type": "purchase",
      "label": "Add to cart",
      "url": "https://www.handsomecalavera.com/cart/add/HC-BAG-017",
      "availability": "online"
    },
    {
      "type": "support",
      "label": "Ask a product expert",
      "url": "https://www.handsomecalavera.com/pages/contact",
      "availability": "24/7",
      "owner": "[email protected]"
    },
    {
      "type": "notification",
      "label": "Notify me when Onyx restocks",
      "url": "https://www.handsomecalavera.com/products/commuter-satchel#notify",
      "availability": "online"
    }
  ],
  "related_products": [
    { "product_id": "HC-WLT-004", "name": "Signal Shield Passport Wallet", "url": "https://www.handsomecalavera.com/products/passport-wallet" },
    { "product_id": "HC-ACC-011", "name": "Leather Cable Organizer", "url": "https://www.handsomecalavera.com/products/cable-organizer" }
  ]
}
Copy & paste template 
{
  "template": "ecommerce_product_page",
  "version": "1.0.0",
  "updated_at": "YYYY-MM-DDThh:mm:ssZ",
  "product": {
    "id": "PRODUCT-ID",
    "sku": "SKU",
    "name": "Product name",
    "slug": "product-slug",
    "url": "https://www.YOUR-DOMAIN.com/products/product-slug",
    "category": ["primary-category", "secondary-category"]
  },
  "summary": {
    "headline": "Hero promise.",
    "subheadline": "Supportive detail.",
    "bullets": ["Key feature", "Proof point", "Benefit"]
  },
  "media": [
    { "type": "image", "src": "https://www.YOUR-DOMAIN.com/path.jpg", "alt": "Description", "position": 1 }
  ],
  "pricing": {
    "currency": "USD",
    "amount": 0,
    "compare_at": null,
    "discount": { "label": "Optional label", "amount_off": 0, "expires_at": null }
  },
  "inventory": {
    "status": "in_stock",
    "quantity": 0,
    "backorder_policy": "Policy text",
    "fulfillment": [{ "region": "Region name", "estimate": "Time frame" }]
  },
  "variants": [
    {
      "id": "VARIANT-ID",
      "options": { "size": "M", "color": "Black" },
      "sku": "SKU-VAR",
      "inventory": { "status": "in_stock", "quantity": 0 }
    }
  ],
  "specifications": {
    "dimensions": "Length × Width × Height",
    "weight": "0",
    "materials": ["Material one"],
    "care": "Care instructions"
  },
  "policies": {
    "warranty": "Warranty details",
    "returns": "Return window",
    "sustainability": "Eco details"
  },
  "evidence": [
    { "type": "review", "source": "Source name", "value": "Quote or rating", "url": "https://link" }
  ],
  "actions": [
    { "type": "purchase", "label": "Add to cart", "url": "https://www.YOUR-DOMAIN.com/cart/add/SKU", "availability": "online" }
  ],
  "related_products": [
    { "product_id": "RELATED-ID", "name": "Related name", "url": "https://www.YOUR-DOMAIN.com/products/related" }
  ]
}