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

# Widget Configuration

> Customize ARIS widget colors, position, greeting, and branding.

All configuration is done in the ARIS dashboard — no code changes needed after the initial embed.

## Settings

| Setting              | Options                       | Default                                                  |
| -------------------- | ----------------------------- | -------------------------------------------------------- |
| **Primary color**    | Any hex color                 | `#a855f7`                                                |
| **Secondary color**  | Any hex color                 | `#ec4899`                                                |
| **Chat position**    | `bottom-right`, `bottom-left` | `bottom-right`                                           |
| **Button style**     | `rounded`, `square`, `pill`   | `rounded`                                                |
| **Button text**      | Any string                    | `"Chat with AI"`                                         |
| **Title**            | Any string                    | Your brokerage name                                      |
| **Subtitle**         | Any string                    | `"here to find your next home"`                          |
| **Greeting message** | Any string                    | `"Hi! How can I help you find your perfect home today?"` |
| **Logo URL**         | Image URL                     | None                                                     |
| **Avatar enabled**   | `true` / `false`              | `false`                                                  |

## Viewing current config

<Tabs>
  <Tab title="CLI">
    ```bash theme={null}
    npx @aris/cli config
    ```
  </Tab>

  <Tab title="API">
    ```bash theme={null}
    curl -H "X-ARIS-API-Key: aris_yourkey" \
      "https://dqgynnlsclfbqysauesf.supabase.co/functions/v1/api-router/v1/config"
    ```
  </Tab>
</Tabs>

## How configuration works

1. You update settings in the ARIS dashboard
2. The widget fetches its config from `/v1/config` on every page load
3. Colors, position, greeting, and branding are applied dynamically
4. No rebuild or redeploy of your site is needed