# Product cards in visitor chat

Share product information in chat and let visitors choose available options and use supported purchase actions.

*Release 3.3 · operator, visitor*

**Settings › Commerce › Product Cards** · **Settings › Chat › Themes**

## What it is

**Product Cards** put product information inside a conversation. A card can show images, descriptions, prices, availability and selectable product options. Where a storefront action is connected, visitors can choose an available variant and add it to their basket.

## Who uses it and why

Operators share relevant products without asking visitors to search again. Visitors compare products, select options and follow the available product or purchase actions.

## Where to find it

Operators use the product browsing area beside the conversation and add products to the reply. Visitors see the resulting cards in chat.

A user with the **Settings** role manages appearance in **Settings › Commerce › Product Cards** and selects **Product card configuration** in **Settings › Chat › Themes**, under **Rich Content**.

## How it works

1. The operator finds a product and selects **Add to reply**, or adds it by clicking, dragging or copying the supported product content into the reply.
2. After the message is sent, the visitor sees the product card. Multiple products can be presented together in a navigable list.
3. The visitor selects the required options. Unavailable combinations cannot be chosen as available purchases.
4. If offered, the visitor chooses a valid quantity and selects **Add to cart**. Some presentations first offer **Choose options**.
5. INSIDE displays the action result. A successful cart action shows **Added to cart**; a failed or unavailable action shows an error instead.

Product imagery, pricing and availability come from the connected commerce data. Display settings control their presentation.

## Configure it

Ask a user with the **Settings** role to choose a product-card configuration and attach it to the visitor's theme. Your commerce integration must supply the product information and any supported basket actions.

Check a product with multiple options as well as an unavailable variant. Verify the action on the actual storefront; the theme preview can simulate an action and does not establish that the shop's basket has changed.

### Settings

| Setting | Where | Applies to | Default | Who can change it | What it does |
|---|---|---|---|---|---|
| Product card configuration | Settings › Chat › Themes › Rich Content › Settings | website | Not set | Settings role | Select a reusable product-card appearance for the theme; unresolved selections use the renderer's default presentation. |

### Permissions

| Permission | Lets you |
|---|---|
| Settings | Manage product-card configurations and select them in themes. |

## Limits and good to know

- Product information and available actions depend on the connected commerce provider and storefront integration.
- The visitor must select an available combination and a valid quantity before the cart action can proceed.
- Quantity rules can include a minimum, maximum and increment supplied for that action.
- A product card without a cart action directs the visitor to open the product page to purchase.
- An unavailable action does not mean a purchase succeeded. Use the success or error shown by the action.

## Depends on and works with

### This feature uses

- **Requires** [Rich content in visitor chat](VX-018.md): Product cards use rich-content message rendering.
- **Configured in** [Product card configuration and shopping actions](COM-014.md): Product-card configurations control presentation.
- **Configured in** [Visitor chat themes and branding](VX-003.md): The active theme selects the product-card configuration.
- **Works better with** [AI product suggestion settings](AI-027.md): AI recommendations can provide product cards.
- **Works better with** [Product options and variant selection](COM-008.md): Product lookup can fill in missing variant details before supported product choices become available.
- **Works better with** [Store product selection for chat](COM-009.md): Operators can browse products and add them to a reply.
- **Works better with** [Add to cart from product cards](COM-016.md): Supported storefront integrations provide basket actions.

### Used by

- **Required by** [Product options and variant selection](COM-008.md): Visitors select product options through the product-card controls in chat.
- **Required by** [Add to cart from product cards](COM-016.md): The visitor's product controls dispatch the confirmed action.
- **Enhances** [Rich content in visitor chat](VX-018.md): Product cards add commerce content and supported product interactions.
- **Enhances** [Product card configuration and shopping actions](COM-014.md): Provides the visitor's product selection and action experience.

## FAQ and troubleshooting

### Why does the card ask the visitor to choose options?

The product needs an available variant selection before it can be added. Choose the required options shown on the card.

### Why can a colour or size not be selected?

That choice may have no available variant for the current combination. Check the product's availability in the connected catalogue.

### Why is Add to cart missing or unavailable?

The content may not include a supported cart action, the storefront integration may not provide it, or the selection and quantity may be invalid. The product-page link remains the purchase route where offered.

### Why does the theme preview succeed while the website action fails?

The preview can simulate success. The live website requires the connected storefront action and valid product data.