Loading…
Docs
Learn how to structure your product catalog for UCP, including attributes, variants, pricing, and availability.
Last updated: February 3, 2026
This content is based on official sources and ecosystem developments:
Your UCP product catalog must follow a standardized structure to ensure AI agents can parse and understand your products.
Products with variants (size, color, etc.) must be structured clearly:
{
"id": "prod_123",
"name": "Running Shoes",
"variants": [
{
"id": "var_123_1",
"attributes": {
"size": "10",
"color": "black"
},
"price": {
"amount": 12999,
"currency": "USD"
},
"availability": "in_stock",
"sku": "RUN-SHOE-10-BLK"
}
]
}
{
"price": {
"amount": 12999,
"currency": "USD"
}
}
Amount is in smallest currency unit (cents for USD).
in_stock: Available for purchaseout_of_stock: Not availablepreorder: Available for pre-orderbackorder: Available for backorderUpdate availability in real-time:
Use our UCP readiness checker to validate your feed.
Problem: AI agents can't distinguish product options
Solution: Structure all product options as variants with clear attributes.
Problem: Prices shown to users don't match actual prices
Solution: Update prices in real-time, cache for maximum 5 minutes.
Problem: Products shown as available but out of stock
Solution: Sync inventory status immediately when stock changes.