Chatbox
Chatbox Settings
Overview
💬Get free consultation

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:

PartWhat it does
Display chatbox on your storeTurns the chatbox on or off.
Chatbox modePicks AI Mode or Legacy chatbox. Each mode has a gear icon that opens its own settings.
Shared chatbox settingsSettings that apply to both modes.

How the settings work together

  1. Turn on the chatbox. Nothing shows on your store until it is on.
  2. Choose one mode. Your store runs one mode at a time.
  3. Set up that mode. The mode's own page holds its messages and appearance.
  4. 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

ModeSet it up in
AI ModeAI Mode
Legacy chatboxLegacy 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.

CardAI ModeLegacy chatbox
Brand colorsShared with Legacy. See Brand colors below.Shared with AI Mode. See Brand colors below.
Chatbox buttonSet the AI Mode buttonSet the Legacy chatbox button
Chatbox styleNot availableSet 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.

  1. Open AI Mode or Legacy chatbox, then click Appearance.
  2. In Brand colors, pick a light or dark background.
  3. 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.
  4. 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.

Brand colors in AI Mode on a light background, each preset showing a preview of AI Mode

Brand colors in AI Mode on a dark background, each preset showing a preview of AI Mode

The Custom tab shows different colors in each mode:

ColorsAI ModeLegacy chatbox
Header colorsBrand 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 colorNot available. AI Mode keeps its own text colors.Yes
Text colorYesYes
Button background color, Button label colorYes. Used for the send button, chat buttons and outlines.Yes

The Custom tab in AI Mode, with the brand gradient, its preview and the button colors

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.

Shared chatbox settings card

SettingWhat it does
Pre-chat formCollects the shopper's details and sets how a chat starts.
Deep linksLinks that open the chatbox, a section of it, or a prefilled question.
Embedded chatboxPlaces the chatbox inside a page of your store.
Display rulesPicks the devices and pages that show the chatbox.
Custom CSSAdds your own styles to the chatbox.
Continue as emailLets shoppers move the chat to email.
Shopping bag buttonsSets where shoppers go from the chatbox cart.
Chat avatarPicks 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.

The Set once for both modes card with the Manage shared settings button

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

The Pre-chat form row open, with the start options and the Add contact field button

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

The Display rules row open with devices and 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.

The Continue as email row in Shared chatbox settings

Shopping bag buttons

Shopping bag buttons sets where shoppers go from the chatbox cart.

  1. Go to Chatbox. In the Shared chatbox settings card, click Shopping bag buttons.

  2. Choose one option.

    The Shopping bag buttons row open with three options

OptionWhat 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 cartThe checkout button, plus a View cart button that opens your store's cart page.
View cart onlyOnly View cart. Use it when customers must fill in something on your cart page, for example invoice details or order notes.
  1. 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.

  1. Go to Chatbox. In the Shared chatbox settings card, click Chat avatar.

  2. Pick one option.

    The Chat avatar row open with Store branding and Team member profile

OptionWhat shoppers see
Store branding (default)Your store logo and name on every team reply. Click Edit store logo to change the logo.
Team member profileThe name and photo of the team member who replies. Click team member to set up profiles.
  1. 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.