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

# Widget customization

> Control where Clara appears, how she looks, and what she says first - from the dashboard, no code.

Widget appearance is configured on the agent in your Clara dashboard and applies to every embed - change it once, and it propagates to all your pages on the next session. No redeploy.

## Position

| Option          | Behavior                           |
| --------------- | ---------------------------------- |
| **Right**       | Bottom-right floating widget       |
| **Left**        | Bottom-left floating widget        |
| **Center**      | Centered floating widget           |
| **Center mini** | Smaller centered variant           |
| **Full**        | Fills the container - inline embed |

## Appearance

| Setting           | Options                                           |
| ----------------- | ------------------------------------------------- |
| Theme             | Dark or light default                             |
| Color mode        | Solid accent color, or a gradient from two colors |
| Button text color | Contrast color for widget buttons                 |

<Note>
  Clara's brand look pairs well with a blue-to-purple gradient - set the gradient start and end hex values in the widget settings.
</Note>

## Branding

| Setting      | Description                                |
| ------------ | ------------------------------------------ |
| Company name | Your brand name shown in the widget header |
| Company logo | URL of your logo, shown in the widget      |
| Agent name   | How Clara is introduced to visitors        |
| Sub-text     | Short line under the header                |

## Buttons and suggested topics

* **Button text** - custom text for the start, talk, and chat buttons
* **Suggested topics** - starter prompts shown to visitors to kick off the conversation

## Allowed domains

Restrict which origins can embed your agent:

1. In the widget settings, enable **Allowed domains**.
2. Add every origin that should embed Clara, including the scheme - for example `https://clarasdr.ai` and `https://trugen.ai`.
3. Save. Embeds from other origins are rejected.

<Warning>
  Enable allowed domains in production. Without it, anyone can embed your widget and consume your conversation usage.
</Warning>

## Where changes apply

Dashboard changes take effect on the **next conversation** - active conversations finish on the previous configuration. Nothing to redeploy, no client-side changes needed.