Chatbox settings
Set up the chatbox once: turn it on, pick a mode, and choose the settings both modes share.
The chatbox is the chat window on your store. Shoppers use it to ask questions, track orders and contact you.

Where to find chatbox settings
Go to Chatbox in your Chatty admin. The page has three parts, from top to bottom:
| Part | What it does |
|---|---|
| Display chatbox on your store | Turns the chatbox on or off. |
| Chatbox mode | Picks AI Mode or Legacy chatbox. Each mode has a gear icon that opens its own settings. |
| Shared chatbox settings | Settings that apply to both modes. |
How the settings work together
- Turn on the chatbox. Nothing shows on your store until it is on.
- Choose one mode. Your store runs one mode at a time.
- Set up that mode. The mode's own page holds its messages and appearance.
- Set the shared settings. They apply to both modes, so you set them once.
Turn on chatbox
Use the Display chatbox on your store switch at the top of the Chatbox page. It saves as soon as you flip it.
Choose the chatbox mode
| Mode | Set it up in |
|---|---|
| AI Mode | AI Mode |
| Legacy chatbox | Legacy chatbox |
Not sure which one fits? See AI Mode or Legacy.
Appearance settings
Each mode has its own Appearance tab. To open it, go to Chatbox, click the gear icon on the mode, then click Appearance.
| Card | AI Mode | Legacy chatbox |
|---|---|---|
| Brand colors | Shared with Legacy. See Brand colors below. | Shared with AI Mode. See Brand colors below. |
| Chatbox button | Set the AI Mode button | Set the Legacy chatbox button |
| Chatbox style | Not available | Set the Legacy chatbox style |
Brand colors
Brand colors set the colors of your chatbox. They are shared: a change in one mode also shows in the other.
- Open AI Mode or Legacy chatbox, then click Appearance.
- In Brand colors, pick a light or dark background.
- Choose colors in one of two ways:
- Preset: pick one of 10 color themes. Cloud is the default. If Chatty finds your store's color, a Your brand theme shows first. Click Surprise me for a random theme.
- Custom: set each color yourself.
- Click Save.
Some themes have their own light and dark colors. Switching the background then changes your header and button colors too, and a note tells you so.
AI Mode uses the same theme as the Legacy chatbox. The two header colors of a theme fill the customer's messages, the AI icon and the avatar, and add a soft tint to the top of the chat panel. The button color is used for the send button, chat buttons and outlines. Text keeps AI Mode's own colors so it stays easy to read. In AI Mode, each preset shows a small preview of AI Mode in that theme.


The Custom tab shows different colors in each mode:
| Colors | AI Mode | Legacy chatbox |
|---|---|---|
| Header colors | Brand gradient with Gradient color 1 and Gradient color 2. A preview below shows how AI Mode looks. | Header background color, or Gradient header with 2 colors. Same colors as the AI Mode brand gradient. |
| Header text color | Not available. AI Mode keeps its own text colors. | Yes |
| Text color | Yes | Yes |
| Button background color, Button label color | Yes. Used for the send button, chat buttons and outlines. | Yes |

If two colors are hard to read together, a warning shows. Pick colors with stronger contrast.
Shared chatbox settings
These settings sit in the Shared chatbox settings card on the Chatbox page. They apply to both AI Mode and the Legacy chatbox.

| Setting | What it does |
|---|---|
| Pre-chat form | Collects the shopper's details and sets how a chat starts. |
| Deep links | Links that open the chatbox, a section of it, or a prefilled question. |
| Embedded chatbox | Places the chatbox inside a page of your store. |
| Display rules | Picks the devices and pages that show the chatbox. |
| Custom CSS | Adds your own styles to the chatbox. |
| Continue as email | Lets shoppers move the chat to email. |
| Shopping bag buttons | Sets where shoppers go from the chatbox cart. |
| Chat avatar | Picks the avatar shown in the chat. |
Most rows open when you click them. Embedded chatbox has its button on the row itself, and Continue as email has its switch there. Click Save after a change.
On the AI Mode and Legacy chatbox pages, the Set once for both modes card lists the same settings. Click Manage shared settings there to open the Chatbox page, where this card is.

Pre-chat form
It helps you collect customer information if you set "chat as guest" as a way to start a chat.
You can collect: email, name and phone number. Click Add contact field to add one. Each field, email included, can be set to Required or Optional, and you can remove any of them.
How customers start a chat is a choice inside the same row:
- Chat as guest: Need to submit a form to start chatting
- Chat as anonymous: Stay anonymous and don't need to submit a form
- Show both options

Deep links
Learn how to use deep links and smart links.
Embedded chatbox
Learn how to add an embedded chatbox to a page.
Display rules
- Devices: All devices, Desktop only or Mobile only
- Pages: Show on all pages, Show on specific pages or Hide on specific pages

Learn how to match pages by URL pattern.
Custom CSS
Custom CSS lets you add custom styles to your chatbox. This required knowledge of coding. If you need any help, contact us through live chat in the app
Continue as email
This helps customers keep their conversation going by email instead of live chat.
Turn on Continue as email in Shared chatbox settings. In chatbox, customers can select Continue as email to keep the conversation going by their email.

Shopping bag buttons
Shopping bag buttons sets where shoppers go from the chatbox cart.
-
Go to Chatbox. In the Shared chatbox settings card, click Shopping bag buttons.
-
Choose one option.

| Option | What customers get |
|---|---|
| Checkout only (default) | One button that goes straight to checkout. It reads Complete order in AI Mode and Buy in the Legacy chatbox. |
| Checkout and View cart | The checkout button, plus a View cart button that opens your store's cart page. |
| View cart only | Only View cart. Use it when customers must fill in something on your cart page, for example invoice details or order notes. |
- Click Save.
Expected result: The shopping bag on your storefront shows the buttons you chose, in both chatbox modes. Check the change on your storefront.
Chat avatar
Chat avatar sets the picture and name shoppers see next to replies from your team.
-
Go to Chatbox. In the Shared chatbox settings card, click Chat avatar.
-
Pick one option.

| Option | What shoppers see |
|---|---|
| Store branding (default) | Your store logo and name on every team reply. Click Edit store logo to change the logo. |
| Team member profile | The name and photo of the team member who replies. Click team member to set up profiles. |
- Click Save.
Expected result: Replies from your team show the avatar you picked. A team member without a photo, or a store without a logo, shows initials instead.
This setting only changes replies from your team. Replies from your AI agent keep the AI's own avatar.
Unread message counter
The message counter is a small number badge that appears on your chat widget icon.
It shows your visitors how many new messages from your store they have not read yet. The count clears when they open the chatbox.

Chatty Help Center