> 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 the chat button

Customizing your bot’s chat button will help you ensure that your bot is
easy to access and fits within your branding guidelines.

Keep in mind that the chat button should be a visually familiar icon
that’s easy to find. You can do things like change the shape of the
button, add text or a custom image, and change its background color.

1. On the Ada dashboard, go to **Settings** > **Bot Setup** > **Bot
   Customization**, then open the **Chat button** drawer.

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

2. In the Chat button drawer, select your preferred button style, and
   then further adjust its appearance. As you make changes to your
   settings, the preview updates on the right side of the screen.

   * **Round button** ![](/_fern-files/_img/160afeb27bf37e7ff69872905ffe47efeef893f69411f3b00ffbdb9ae6f6dd9c.webp)

     1. Under **Icon**, choose the type of icon you want to appear on
        your chat button.
     * Click **Default** to just have a speech bubble on your chat
       button.

     * Click **Custom Icon** to upload an .svg file to appear on
       your chat button.

       #### Upload a custom image

       1. By default, your bot comes with a preloaded custom icon.
          To replace it, click the **Delete** button ![](/_fern-files/_img/eaf3e27905dfafde4c1138201d5674737788133775fed7625fcd3f098c6628f3.webp) beside the existing file path.
       2. Click the **Upload** button ![](/_fern-files/_img/f9841202b2f05f473d08612dc758fa9e388f0eb0fa5e92068963a3954053479f.webp), then upload the .svg file of your choice.
     3. Under **Background color**, either click the color swatch to
        use a color picker, or paste in a hex code to choose the color
        for your button.
     4. Under **Button size**, choose how big you want your button to
        be.

   * **Text button** ![](/_fern-files/_img/411adb855737a69f2d890700ddc5398b621564481cd55fc07742164ef9916700.webp)

     1. Under **Background color**, either click the color swatch to
        use a color picker, or paste in a hex code to choose the color
        for your button.
     2. You can add custom text for each language that your bot
        supports. Beside the **Button text** field, choose the
        language you want to add the custom text for, and then in the
        field, enter the text you want to appear on the button. The
        button text can be up to 18 characters long.

3. Click **Save Changes**.

If your bot is live, the changes you make to your chat button appear
immediately to your chatters once you save them.

---

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