> ## Documentation Index
> Fetch the complete documentation index at: https://docs.chatref.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Agent Settings

> Set your bot's names, description, button label, dark mode, and the messages visitors see first.

The **Settings** tabs hold the details that name your bot and shape what visitors
see first. Everything here **saves automatically** – there's no Save button. This
page covers the **General** and **Messages** tabs. Your bot's **model**,
**personality**, and **system prompt** live in the **Playground**, not here.

## Where settings live

Settings is split into tabs:

| Tab | What it covers |
| - | - |
| **General** | Names, description, button label, dark mode (this page) |
| **Appearance** | Colors, logo, widget icon, position |
| **Messages** | Welcome message, opening bubble, suggested questions (this page) |
| **Actions** | Buttons in the widget header |
| **Display Rules** | Which pages the widget appears on |

For everything except General and Messages, see the **Widget Customization**
pages, starting with [Appearance](/widget/appearance).

## General

The **General** tab holds your bot's identity and theme.

| Setting | What it does |
| - | - |
| **Agent name** | The name you see in your dashboard. Visitors never see it. |
| **Bot name** | The name shown in the chat, like "Bean & Brew Assistant". |
| **Description** | A short note for your own reference. Up to **200 characters**. |
| **Button label** | The text on the chat launcher button. Up to **30 characters**. |
| **Dark mode** | A toggle for a dark theme. **Off by default** – your bot starts in light mode. Turn it on for a dark look. |

<Note>
  New bots start in **light mode**. Dark mode is off until you turn it on here.
</Note>

## Messages

The **Messages** tab controls the first things a visitor sees.

| Setting | What it does |
| - | - |
| **Welcome message** | The greeting inside the chat when a visitor opens it. Up to **100 characters**. |
| **First message** | The bubble that pops up on its own near the launcher to invite a chat. Up to **300 characters**. |
| **Suggested messages** | Clickable starter questions that help visitors begin. |

<Tip>
  Make your suggested messages match what people actually ask. A coffee store might
  add "Where's my order?" and "How do subscriptions work?" so visitors get going in
  one tap.
</Tip>

## Next steps

<CardGroup cols={2}>
  <Card title="Appearance" icon="paint-roller" href="/widget/appearance">
    Set colors, your logo, the launcher icon, and where the widget sits.
  </Card>

  <Card title="The Playground" icon="bolt" href="/agents/playground">
    Set your bot's model, personality, and system prompt here.
  </Card>
</CardGroup>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.