Collections

Collections put your products, services, or any curated content right inside customer conversations. When someone asks "What do you sell?" or "Show me your options," your AI agent can present a visual carousel of items — with images, descriptions, and action buttons.

Think of a collection as a mini storefront inside your chat. Customers browse, tap, and take action without ever leaving the conversation.

What collections give you

• Visual product cards in chat — Customers see items as carousels, not walls of text
• AI-driven selling — The agent finds and presents the right items based on what customers ask for
• One place to manage catalogs — Everything lives in the Cloodot dashboard
• Bulk imports — Upload a CSV to add hundreds of items at once
• Shopify integration — When connected, your AI agent references Shopify product data alongside your collections

Opening Collections

Go to Intelligence → Collections from your dashboard. You'll see all your collections and can create new ones from here.

Creating a collection

1. Click Create Collection.
2. Give it a name (e.g., "Summer Sale" or "Our Services").
3. Add an optional description so your team knows what it's for.
4. Save it.

That's it — your collection is ready for items.

Adding items to a collection

Each item in a collection can have:

• Title — The name of the product or service (required)
• Subtitle — A short description, price, or details
• Image — A photo of the product or service
• Buttons — Up to 2 action buttons (like "View Details" or "Buy Now")

Adding items one by one

1. Open the collection.
2. Click Add Item.
3. Fill in the title, subtitle, and other details.
4. Add buttons if customers should be able to take action.
5. Save.

Importing items from a CSV

Got a spreadsheet of products? Import them in one go.

1. Open the collection and click Import.
2. Upload your CSV (up to 10 MB, up to 1,000 rows).
3. Map your columns — title, subtitle, image URL, and so on.
4. Review the mapping and start the import.
5. Watch the progress as items are added.

If your CSV contains items already in the collection, choose whether to skip duplicates or update them with the new data.

How your AI agent uses collections

When a customer asks something like:

• "What phones do you have?"
• "Show me your dessert menu"
• "Do you have anything under $50?"

The agent searches your collections, finds the most relevant items, and presents them as a visual carousel in the conversation. Customers can scroll through items, see images and descriptions, and tap buttons to take action.

Search is semantic — it understands meaning, not just keywords. So "affordable laptops" finds items even if the word "affordable" doesn't appear in your data.

Item details

Images

Add product photos to make items stand out. Provide an image URL or upload a file. Supported formats: PNG, JPEG, or WebP, up to 5 MB.

A good image is the difference between a customer scrolling past and stopping to look.

Buttons

Each item can have up to 2 buttons. Two types:

• URL — Opens a link (great for "View Product" or "Learn More")
• Postback — Sends a message back to the conversation (useful for "I'm interested" or "Add to cart")

Managing collections

Edit a collection

Click any collection to change its name or description. You can also add, edit, or remove items here.

Edit items

Click any item to update its title, subtitle, image, or buttons. Changing the title or subtitle re-indexes the item, so your agent can find it with the updated text.

Delete items or collections

You can delete individual items or entire collections. Deleting a collection removes all its items too.

Plan limits

The number of collections you can create depends on your plan:

There's no limit on the number of items within each collection — add as many as you need.

Tips for great collections

Write clear titles

"iPhone 15 Pro Max 256GB" beats "Product #4829." Customers see titles, and your agent uses them to match search queries.

Add descriptive subtitles

Include price, size, color, or availability. Subtitles help customers decide and help your agent find the right items.

Use quality images

A clear product photo builds trust and makes your carousel look professional. Make sure image URLs are publicly accessible and load quickly.

Keep collections focused

"Winter Jackets" beats "All Products." Smaller, well-organized collections help your agent serve up more relevant results.

Update regularly

Remove discontinued items, update prices, and add new products. Stale collections frustrate customers.

Troubleshooting

Agent isn't showing collection items

Make sure you have at least one collection with items. Then:

• Check that items have titles (required for search indexing)
• Give newly added items a moment to be indexed — it's not instant

Images aren't displaying

Check that the image is in a supported format. Then:

• Confirm it's a PNG, JPEG, or WebP file (up to 5 MB)
• Make sure the image is publicly accessible (not behind a login)

CSV import issues

Check that your file is under 10 MB and has fewer than 1,000 rows. Then:

• Make sure it's a valid CSV with column headers
• Verify every row has a title — it's the only required field

Related

• Knowledge Base — Teach your agent about your business with text, PDFs, and web links
• AI Agent — Configure how the agent uses collections and other tools
• Skill Sets — Add custom abilities
• Integrations — Connect Shopify and other services

What's next?

1. Create your first collection and add a few items.
2. Test it in the playground — ask the agent about the products you added.
3. Build your Knowledge Base to complement collections with policies and FAQs.
4. Connect Shopify to give the agent access to your store's product data.

---

Ready to teach your agent more? Build your Knowledge Base.