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

# Widget customization

> Customize the look and feel of your chat widget to match your brand.

The chat widget is what your visitors interact with. Customize it to feel native to your website.

## Appearance

| Setting              | Description                                                                          |
| -------------------- | ------------------------------------------------------------------------------------ |
| **Brand color**      | Primary color used for the chat header, send button, and widget trigger              |
| **Theme**            | Light, dark, or auto (follows the visitor's system preference)                       |
| **Button icon**      | Choose from presets (message circle, chat, help, support, bubble) or upload your own |
| **Button shape**     | Round or square trigger button                                                       |
| **Button animation** | Default, bounce, slide, fade, or none                                                |
| **Position**         | Bottom-left or bottom-right of the screen                                            |

## Custom icon upload

You can upload your own icon for the widget trigger button:

1. Go to **My AI Agent** in the sidebar, click your agent, then open the **Widget** tab
2. Under **Button icon**, select **Custom**
3. Upload your image (PNG or SVG recommended)

The icon is stored securely and served from InboxMate's CDN.

## Greeting and presence

* **Greeting message** — shown when the widget opens (supports EN and DE)
* **Presence indicator** — shows an online status dot on the widget trigger
* **Delayed messages** — timed messages that appear to engage visitors who haven't opened the chat yet (supports multi-language)

## Quick questions

Predefined questions shown as clickable chips when the chat opens. Configure separate sets for English and German:

* Add up to 10 questions per language
* Keep them short (under 40 characters)
* Focus on your most common customer queries

## Multi-language support

The widget automatically detects the visitor's browser language and shows content in the matching language (English or German). This applies to:

* Greeting messages
* Quick question suggestions
* Delayed messages
* Human handover labels
* UI elements

See [multi-language](/user-guide/chatbot/multi-language) for details on how language detection works.

## Domain whitelist

Restrict where your widget can load by specifying allowed domains. This prevents unauthorized use of your agent on other websites.

```text theme={null}
example.com
www.example.com
shop.example.com
```

<Warning>
  If no domains are whitelisted, the widget will load on any site that has your embed code.
</Warning>

## Page visibility

Control which pages show the widget using URL patterns:

* **Show on pages** — only display the widget on matching URLs
* **Hide on pages** — hide the widget on matching URLs

## Branding

* **Starter** and **Pro** plans include "Powered by InboxMate" branding
* **Business plan** can remove branding
* **Business plan** supports full white-label (custom branding)