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

# Configuration

> Customize widget appearance and behavior

## Branding Settings

The widget automatically inherits your AI teammate's branding. Configure these in **Branding** → **Design** and **Content** tabs:

| Setting | Where | Widget Effect |
| - | - | - |
| Accent Color | Design tab | Bubble background color |
| Background Color | Design tab | Frame border/shadow tinting |
| Theme | Design tab | Light/dark tooltip styling |
| Bot Avatar | AI teammate settings | Bubble icon |
| Message Greetings | Content tab | Stacked greeting bubbles above the button |
| Conversation Starters | Content tab | Quick-action buttons in the chat |
| Input Placeholder | Content tab | Chat input hint text |

## Widget-Specific Settings

These are configured in **Branding** → **Design** tab under the **Chat Widget** section:

### Position

Choose where the bubble appears on the page:

* **Bottom Right** (default)
* **Bottom Left**

### Auto Open

Automatically open the widget after a delay when the page loads.

* **Enable/Disable** toggle
* **Delay** — seconds before the widget opens (1–60, default 5)

### Open Style

Choose how the chat opens when a visitor clicks the bubble:

* **Normal** — opens the current floating chat window.
* **AI teammate dock** — shows a centered input-style launcher at the bottom of the page and expands into a wider chat panel.

Dock mode is useful when the widget should feel closer to the hosted chat: always visible as a prompt bar, less interruptive than a bubble, and strong for marketing pages that invite visitors to ask a question directly.

The default desktop dock width is `720px`. You can change it in Branding → Chat Widget or by passing `data-dock-width` / `dockWidth` in the embed setup.

## Greeting Bubbles

The widget shows your **Message Greetings** (from Content tab) as stacked chat bubbles above the floating button. Each greeting appears as a separate message card.

Clicking any greeting bubble opens the widget.

To configure greetings:

1. Go to **Branding** → **Content** tab
2. Enable **Message Greetings**
3. Add 1–4 greeting messages

If greetings are disabled, only the floating bubble button is shown.

## Passing Context

You can pass metadata from your website to the conversation:

```js theme={null}
boostgpt.init({
  botId: 'YOUR_BOT_UUID',
  metadata: {
    page: 'pricing',
    plan: 'pro',
    userId: '12345',
  },
});
```

Metadata is available to your AI teammate as conversation context, allowing them to personalize responses based on what page the user is on or what product they're viewing.

## Mobile Behavior

On screens narrower than 480px, the widget iframe expands to full-screen when opened, providing a native app-like experience.


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