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

# Customization

> Control the widget name, greeting, icon, colours, position and languages

## Overview

Every visual and behavioural setting lives in the dashboard, not in your
website's code. Edit a widget, save, and the change reaches your live site
within about a minute.

<Info>
  Your embed snippet never changes. This means marketing or support staff can
  adjust wording and branding without a developer or a site deploy.
</Info>

***

## Identity

### Bot Name

The name shown in the widget header and used in the transcript labels. Leave it
blank to fall back to the agent's own name.

Pick something a visitor would expect to be talking to — a first name works well
for support and sales.

### Agent Name

Shown as a smaller subtitle under the bot name, so visitors know which service
they have reached. It comes from the agent itself and updates automatically if
you rename the agent.

<Note>
  If the bot name and agent name are identical, the subtitle is hidden to avoid
  repeating the same text twice.
</Note>

### Greeting

A short line of text shown before the conversation starts. It is **displayed,
not spoken** — what the agent actually says first comes from its prompt.

Good greetings tell the visitor what the agent can do:

```
Ask me anything about your order.
I can help you book a site visit.
Questions about pricing or plans? Just ask.
```

***

## Icon

Upload a PNG, JPG, WebP or SVG up to 2 MB. It is used in two places: the
launcher button and the panel header.

**Recommendations**

* Square images work best — non-square images are cropped to a circle
* 128×128 px or larger keeps it sharp on high-density screens
* A logo mark reads better than a full wordmark at launcher size

If you do not upload an icon, the launcher shows a microphone symbol and the
header shows the first letter of the bot name on a coloured circle.

***

## Colours

Two colours drive the entire widget.

| Colour        | Used for                                                             |
| ------------- | -------------------------------------------------------------------- |
| **Primary**   | Launcher button, the **Talk** button, and the visitor's own messages |
| **Secondary** | The agent's messages                                                 |

The widget derives its own tints and text colours from these two values, so
bubbles stay readable without you configuring anything else.

<Tip>
  Set the primary colour to your main brand colour so the launcher looks like part
  of your site. Choose a clearly different secondary colour — that visual contrast
  is what makes a transcript easy to follow at a glance.
</Tip>

Both accept standard hex values, and the creation dialog includes a colour
picker with a live preview.

***

## Position

Choose which corner the launcher occupies:

* **Bottom right** — the conventional position, and what most visitors expect
* **Bottom left** — useful when something else already occupies the right corner

<Note>
  If you already run a chat or support widget, put CallKaro in the opposite corner
  so the two do not overlap on smaller screens.
</Note>

***

## Languages

Select every language the widget should offer.

* **One language** — the selector is hidden and conversations start immediately
* **Two or more** — visitors pick their language before starting

The selector locks once a conversation is live, so a visitor cannot switch
language mid-call.

<Warning>
  Only enable languages your agent is actually configured to handle. Offering a
  language the agent cannot speak produces a poor first impression.
  See [switching agent language](/agents/configurations/switch-agent-language).
</Warning>

***

## Status

| Status     | Behaviour                                                   |
| ---------- | ----------------------------------------------------------- |
| **Active** | The widget works normally                                   |
| **Paused** | The launcher does not appear and conversations are declined |

Pausing is the safe way to take a widget offline — it leaves your site untouched
and is instantly reversible, unlike deleting.

***

## Live Preview

The creation and edit dialogs show a scaled replica of the widget beside the
form, updating as you type. It reflects your icon, names, greeting, both colours
and the launcher position.

<Tip>
  Use the preview to check colour contrast before saving. A pale secondary colour
  can leave the agent's messages hard to read, and the preview shows that
  immediately.
</Tip>

***

## What You Cannot Change Yet

For transparency, these are fixed in the current version:

* Panel dimensions and corner radius
* The launcher icon shape (always circular)
* Transcript wording such as "You" and the **Talk** button label
* Custom fonts — the widget uses a neutral system font stack

<Card title="Request a customization" icon="headset" href="mailto:support@callkaro.ai">
  Tell us what you need and we will look at adding it
</Card>