Product Feed Quickstart

What to ship first

• Start with one canonical feed (JSON preferred). Keep product IDs, price, currency, availability, and canonical product URL stable.
• Set `enable_search=true` for products that should appear in conversational discovery.
• Set `enable_checkout=true` only for products where checkout routing and policy handling are production-ready.
• Use explicit variant identity (size/color/version) to prevent mixed recommendations across sibling SKUs.

High-impact enrichment fields

• Add `q_and_a` with short factual clarifications (fit, compatibility, shipping constraints, returns).
• Include `raw_review_data` with timestamps and source context to improve retrieval confidence.
• Use `relationship_type` consistently for bundle/accessory/replacement relationships.
• Keep taxonomy labels stable across sync cycles to reduce retrieval drift.

Minimal product example

• Use this as a shape reference and validate against the latest feed schema before deploy.

{
  "id": "sku_12345",
  "title": "Trail Running Shoe X1",
  "description": "Lightweight trail shoe with reinforced toe guard.",
  "price": "129.00",
  "currency": "USD",
  "availability": "in_stock",
  "url": "https://merchant.example/products/trail-running-shoe-x1",
  "image_url": "https://merchant.example/images/trail-running-shoe-x1.jpg",
  "enable_search": true,
  "enable_checkout": false,
  "q_and_a": [
    { "q": "Is this waterproof?", "a": "Water-resistant upper, not fully waterproof." },
    { "q": "How does sizing run?", "a": "Most customers choose half-size up for thicker socks." }
  ],
  "relationship_type": "standalone",
  "raw_review_data": [
    { "rating": 5, "text": "Great grip on wet rocks.", "created_at": "2026-03-10T00:00:00Z" }
  ]
}

Operational quality gates

• Run a full feed refresh at least daily, with intraday deltas for price and availability changes.
• Keep `last_modified` accurate and monotonic for downstream caching behavior.
• Avoid ID churn across syncs; treat IDs as long-lived references.
• Fail publication when core fields are missing (`id`, `title`, `price`, `currency`, `availability`, `url`).
• Track top retrieval misses weekly and patch source attributes, not just downstream prompts.

Primary References

• OpenAI: Powering product discovery in ChatGPT
• OpenAI Commerce: Feed spec
• ChatGPT Merchants portal