Product cards

Product cards display e-commerce style items — image, title, price, optional compare-at price, SKU, and call-to-action buttons. Use with carousel, grid, list, or single layouts.

Typical fields

Transform field	API source example	Required
`title`	`product.name`	yes
`image_url`	`product.images[0].url`	recommended
`price`	`product.price.amount`	recommended
`currency`	`product.price.currency`	with price
`subtitle`	`product.short_description`	no
`url`	`product.pdp_url`	for “View product” actions
`sku`	`product.sku`	no

Exact keys depend on your JSON — map paths in Transform reference.

Example API shape

{
  "products": [
    {
      "sku": "SHOE-42",
      "name": "Trail Runner Pro",
      "price": { "amount": 129.99, "currency": "USD" },
      "image": "https://cdn.example.com/shoe.jpg",
      "url": "https://shop.example.com/shoe-42"
    }
  ]
}

Transform: items_path: products, card type product, layout grid.

Actions

Define button labels in transform config — e.g. “Add to cart” (deep link) or “Ask about sizing” (continues chat). Actions must point to URLs or behaviors you control.

When to use product vs media

Product cards	Media cards
SKU, cart, catalog semantics	Image-forward offers (hotels, events)
Retail and marketplaces	Travel and hospitality

See Media cards.

Trust policy

Prices and images on product cards come only from successful tool JSON — never from the LLM alone. Trust policy.