Catalog

The Catalog is where you manage the products, services, or items that your agent can reference during conversations. When a user asks about pricing, availability, or product details, the agent pulls information directly from your catalog.

Why use a catalog?

Without a catalog, your agent relies solely on the knowledge base to answer product-related questions. A structured catalog provides:

• Accurate, up-to-date data — prices, descriptions, and availability in a single place.
• Rich responses — the agent can display products as carousels, buttons, or rich lists instead of plain text.
• Extension integration — marketplace extensions like Stripe and Shopify use catalog data to show products and generate payment links.

How it works

1. You add items to the catalog — either manually or by syncing from an extension (e.g., Stripe products).
2. When a user asks a product-related question, the agent searches the catalog.
3. The agent returns matching items using rich UI components (carousels, lists) when available.

Managing catalog items

Adding items manually

1. Go to Catalog in the agent sidebar.
2. Click Add Item.
3. Fill in the item details:
   • Name — the product or service name.
   • Description — a short summary the agent can use in responses.
   • Price — display price (optional).
   • Image URL — product image shown in carousels and cards (optional).
   • URL — link to the product page or checkout (optional).
4. Click Save.

Syncing from extensions

If you have a marketplace extension connected (e.g., Stripe), catalog items can be synced automatically:

• Stripe — products and prices are imported from your Stripe account.
• Shopify — product listings are pulled from your Shopify store.

Synced items update periodically to reflect changes in the source system.

Editing and deleting items

• Click any item in the catalog list to edit its details.
• Use the Delete button to remove items you no longer want the agent to reference.

How the agent uses catalog data

When a user asks something like “What products do you have?” or “How much does the Pro plan cost?”, the agent:

1. Searches the catalog by name, description, or category.
2. Selects the most relevant items.
3. Presents them using the appropriate UI component:

Component	When used	Example
Carousel	Multiple products to browse	”Here are our subscription plans”
Rich list	A list of options or features	”We offer these services”
Buttons	Quick selection from a few items	”Which plan are you interested in?”

For more on UI components, see Extensions.

Best practices

• Keep descriptions concise — the agent includes them in responses, so shorter descriptions work better in chat.
• Add images — visual product cards significantly improve user engagement.
• Include prices — users frequently ask about cost; having prices in the catalog avoids vague answers.
• Review regularly — remove discontinued items and update prices to prevent the agent from sharing outdated information.

Next steps

• Stripe extension — sync products and enable payment links.
• Configure behavior — adjust how the agent presents catalog items.
• Conversations — review how users interact with catalog-powered responses.