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

# Configuration

> Embedding and configuration options for the Homie chat widget.

## Embedding & Configuration

At minimum, set `chatbotId` and `domain` on the script tag. Styling and behavior are managed from the Homie dashboard and pulled in automatically by the embed.

```html theme={null}
<script
  src="https://chat.yourhomie.ai/embed.min.js"
  chatbotId="YOUR-CHATBOT-ID"
  domain="https://chat.yourhomie.ai"
  defer
></script>
```

## Style Settings

Optionally managed via your Homie style settings (fetched by the script):

* `iconColor`, `iconRounded`, `iconImage`, `iconSize`, `iconImagePadding`
* `iconBottomPadding`, `iconSidePadding`, `iconAlign` (`left` | `right`)
* `shadowHostZIndex` (set higher to keep the embedded chat above sticky menus/badges)
* `showHoverText`, `isPrivate`, `active`

## User Configuration

<Note>
  Advanced: Some customers provide <code>window\.homieUserConfig</code> to pass <i>user\_id</i>, <i>user\_hash</i>, and{' '}
  <i>user\_metadata</i>. The embed forwards these safely to the iFrame (Base64‑encoded metadata).
</Note>