> ## 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>