> This page is for version Scripted.
> For other versions, use one of these documentation indexes:
> - Generative (default): https://developers.ada.cx/generative/llms.txt
> - Scripted: https://developers.ada.cx/scripted/llms.txt

> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://developers.ada.cx/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://developers.ada.cx/_mcp/server.

# Customize your bot's branding

## Bot customization overview\[#UUID-628bb378-6983-64c2-4c42-41036002ddfe_id_1500012348861_id_h_01F6MR7404DM0DKCCKA190PYQ8]

When you customize your bot's branding, you can make your bot's
appearance fit seamlessly into your website, from adding your brand
colors to making an eye-catching chat button. You can watch this video
for an overview and an example, or keep reading to learn about how you
can customize how your own bot looks.

## Accessibility\[#UUID-628bb378-6983-64c2-4c42-41036002ddfe_id_1500012348861_id_h_01F6MR7F8TW6FT3BJN777V2AZR]

* Chatters can navigate the entire chat with a keyboard and/or screen
  reader.

* Depending on your brand color, the chat will automatically adjust to
  ensure color contrast between elements on the page. Chat content will
  always have sufficient contrast.

## Access branding customization options\[#UUID-628bb378-6983-64c2-4c42-41036002ddfe_id_1500012348861_id_h_01F6MR79G9P48JP7XZ9XAG0JNE]

To customize your bot, head to **Settings** > **Bot Setup** > **Bot
Customization.**

There are four categories you can customize. Depending on your
organization's subscription package, you may also see additional
[Advanced branding features](#UUID-628bb378-6983-64c2-4c42-41036002ddfe_N1674503311277).

* [General](#UUID-628bb378-6983-64c2-4c42-41036002ddfe_id_1500012348861_id_h_01FDSZXZVMX1Y9KXWH4V3GKDR5)

* [Chat window](#UUID-628bb378-6983-64c2-4c42-41036002ddfe_id_1500012348861_id_h_01FDSZYVVBDX92CSW2F1GSGCEK)

* [Chat button](#UUID-628bb378-6983-64c2-4c42-41036002ddfe_id_1500012348861_id_h_01FDSZZ99KN7P4MEV5V85J5PGN)

* [Fallback message](#UUID-628bb378-6983-64c2-4c42-41036002ddfe_id_1500012348861_id_h_01FDT6HQP2EGTJM2FTYY572V9B)

![](/_fern-files/_img/b80e879e85704c1be33fd28e73e85489e111fc6ae4f5419d9c635da4574707fc.webp)

### General settings\[#UUID-628bb378-6983-64c2-4c42-41036002ddfe_id_1500012348861_id_h_01FDSZXZVMX1Y9KXWH4V3GKDR5]

* Bot name – multilingual

* Bot description – multilingual (optional)

  The bot description is a component that appears at the start of a new
  chat to help set the context. You can use this instead of adding text
  to the Greeting Answer. The component consists of the bot avatar,
  name, and short customizable description (max 80 characters). You can
  turn the bot description on/off in **Bot Customization** >
  **General**, but the feature will be on by default.

  ![](/_fern-files/_img/cf48650cc45a20fa66226f5cd85561829ae46761d47da6a2167d608e9c5732bd.webp)

* Offer [predictive suggestions](/scripted/docs/build-and-maintain-your-bot/create-conversations/offer-predictive-suggestions-for-answers-as-chatters-type)

* Show privacy policy link

* Show Powered by Ada logo

* Enable sound by default

* Allow chatters to email transcript

* Allow chatters to download transcript

### Chat window settings\[#UUID-628bb378-6983-64c2-4c42-41036002ddfe_id_1500012348861_id_h_01FDSZYVVBDX92CSW2F1GSGCEK]

* Advanced colors – Allows you to choose custom text colors in addition
  to background colors. If this setting is toggled off, when you select
  a background color, the text on it defaults to either black or white,
  depending on which provides the best contrast.

* Accent color

* Quick reply button orientation

  * You can choose whether quick reply buttons are stacked on top of
    each other, or side-by-side in a scrollable carousel, and choose
    different settings between desktop and mobile browsers

* Bot avatar

* Live agent avatar – Only available for bots with certain Ada Glass
  integrations

### Chat button settings\[#UUID-628bb378-6983-64c2-4c42-41036002ddfe_id_1500012348861_id_h_01FDSZZ99KN7P4MEV5V85J5PGN]

* Round button option

  * Icon

  * Color

  * Size

### Fallback message settings\[#UUID-628bb378-6983-64c2-4c42-41036002ddfe_id_1500012348861_id_h_01FDT6HQP2EGTJM2FTYY572V9B]

In the rare event that chat services go down, you can create content to show up for customers instead of the usual web chat window.

* **Language**

  Choose the language to create fallback text for.

* **Icon and message**

  Ada provides you with a default error icon and message that you can customize
  or override as necessary.

* **Button labels and URLs (optional)**

  By default, there are no action buttons provided for chat errors;
  however, you can add links to alternate actions or resources if you
  wish. In the **Button label** field, enter the button text to display;
  and in the **URL** field, enter the URL that the button should open
  when clicked.

## Advanced branding features\[#UUID-628bb378-6983-64c2-4c42-41036002ddfe_N1674503311277]

> **Info**
>
> This feature may not be included with your organization's subscription
> package. For more information, see Ada's
> [Pricing](https://www.ada.cx/pricing) page, or contact your Ada team.

### Header color

With advanced branding, you can customize a header color directly in the
the dashboard, in **Bot Customization** > **Chat Window**. This is
independent of the brand color used throughout the rest of the chat.

![](/_fern-files/_img/9f04003742de2ae94119e562ea0ab7234ac0dbc834361c01b4ccab16bd2b2b9a.webp)

### Theme (dark mode)

You can choose from the following settings in **Bot Customization** >
**Chat Window**:

* Light mode

* Dark mode

* Automatically default to user's device

### Chat bubble and styles

You can choose between 2 ways of styling the chat in **Bot
Customization** > **Chat Window**:

* Rounded corners

* Rectangular corners

### Configurable font sizes\[#UUID-628bb378-6983-64c2-4c42-41036002ddfe_section-idm4570979702576033407369407017]

You can choose between 3 font sizes in **Bot Customization** > **Chat
Window**:

* Small (14px body font)

* Standard (16px body font)

* Large (17px body font)

### Chat button with custom text

A custom text button option with customizable icon, color, and text (max
18 characters) can be found in **Bot Customization** > **Chat Button**.

---

Have any questions? Contact your Ada team, or email us at [](<mailto:help@ada.support%20%E2%80%9CHelp Docs inquiry%E2%80%9D>).