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

# Customize the Egentify Chat Widget for Your Brand

> Match Egentify's chat widget to your brand — adjust colors, position, corner radius, welcome text, and quick-reply starter buttons.

The Egentify chat widget is fully customizable to match your storefront's brand without any code changes. Adjust colors, positioning, welcome messaging, and quick-reply buttons to create a seamless experience that feels native to your store.

## Where to customize

<Tabs>
  <Tab title="Shopify">
    **Appearance settings** (colors, welcome text, starter buttons) are in the **Egentify app** in your Shopify admin under the **Settings** tab.

    **Position and offsets** (widget corner, horizontal/vertical offset, corner radius) are configured in your Shopify admin under **Online Store** > **Themes** > **Customize** > **App Embeds** — select the Egentify chat widget entry there.
  </Tab>

  <Tab title="WooCommerce">
    All widget settings are available in your WordPress admin under **Egentify** > **Widget Settings**. No theme editor required — every option is managed from a single page.
  </Tab>
</Tabs>

## Appearance settings

| Setting                       | Description                                                                                                              | Default                 |
| ----------------------------- | ------------------------------------------------------------------------------------------------------------------------ | ----------------------- |
| `primary_color`               | The accent color used for the widget launcher, send button, and interactive elements. Set as a hex value.                | `#3158c1`               |
| `widget_position`             | Which corner of the screen the widget launcher appears in.                                                               | `bottom-right`          |
| `widget_offset_x`             | Horizontal distance (in pixels) between the widget launcher and the edge of the screen. Accepted range: 0–200 px.        | `20`                    |
| `widget_offset_y`             | Vertical distance (in pixels) between the widget launcher and the bottom of the screen. Accepted range: 0–200 px.        | `20`                    |
| `widget_window_corner_radius` | The corner radius of the chat window in pixels. Set to `0` for sharp corners or up to `30` for fully rounded.            | `12`                    |
| `agent_name`                  | The agent's name displayed in the widget header.                                                                         | `Nova`                  |
| `agent_avatar_storage_path`   | A custom avatar image shown in the widget header and next to agent messages. Upload a PNG or JPG from the settings page. | Egentify default avatar |

## Welcome text and starter buttons

The welcome text is the first message customers see when they open the chat widget. Use the `{{agent_name}}` placeholder to automatically insert your agent's name:

```text theme={null}
Hi there! I'm {{agent_name}}. How can I help you today?
```

The welcome text supports up to 300 characters.

Starter buttons appear below the welcome message the first time a customer opens the widget, giving them one-tap shortcuts to common requests. You can configure up to **4 buttons**, each up to **40 characters** long.

**Example starter buttons:**

* `Track my order`
* `Return an item`
* `Product question`
* `Talk to a person`

Choose labels that reflect the most common reasons your customers reach out — this reduces the time it takes for customers to get help and gives the AI useful context from the very first interaction.

<Note>
  Changes to widget settings take effect immediately — no page reload or re-deployment needed.
</Note>