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

# Chat widget

The **Chat Widget** tab lets you configure both the **behavior** and **appearance** of your chatbot widget before embedding it on your website. From greetings and conversation starters to branding and widget controls, this section allows you to tailor the chat experience to match your business.

<Frame>
  <img src="https://mintcdn.com/chatzyai/qIKaZG5_O5n8nqah/ai-agents/conversational-ai-agent/settings/chat-widget1.png?fit=max&auto=format&n=qIKaZG5_O5n8nqah&q=85&s=3768f69971bddeefe04100f8affc842d" width="1664" height="1364" data-path="ai-agents/conversational-ai-agent/settings/chat-widget1.png" />
</Frame>

***

## Conversation Experience

### Introductory Message

The **Introductory Message** is the first message displayed when a user opens the chat widget. Use it to welcome visitors, introduce your AI agent, or explain how it can help.

***

### Conversation Starters

Conversation Starters are predefined prompts that users can click to begin a conversation instantly.

They help reduce friction by guiding users toward common questions or actions.

Examples:

* "Tell me about your pricing."
* "Book a demo."
* "Talk to support."
* "Show available plans."

***

## Authentication

### Enable Auth Access Iframe

Enable this option if you want to restrict access to your chatbot to authenticated users only.

This feature requires an **AI Agent Auth Key (Client API Key)**, which can be generated from the **Profile** page.

After generating your API key, follow the authentication guide here:

[https://docs.chatzy.ai/api-reference/auhtorized-iframe-access/get-access-token](https://docs.chatzy.ai/api-reference/auhtorized-iframe-access/get-access-token)

***

## Widget Features

The following options allow you to enable or disable individual widget capabilities.

| Setting                                     | Description                                                                                                                                     |
| ------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------- |
| **Stream Response**                         | Displays AI responses progressively as they are generated, creating a natural typing effect.                                                    |
| **Collect Files**                           | Allows users to upload files directly during the conversation.                                                                                  |
| **Microphone**                              | Enables voice input so users can speak instead of typing.                                                                                       |
| **Collect Feedback at End of Conversation** | Prompts users to rate or provide feedback after the conversation ends.                                                                          |
| **Show Chatzy Watermark**                   | Displays the **"Powered by Chatzy AI"** watermark at the bottom of the chat widget. Available to disable only on the **Growth** plan and above. |
| **Follow-up Suggestions**                   | Displays suggested follow-up questions or actions after each AI response to encourage continued engagement.                                     |
| **Disable Reset Button**                    | Removes the reset conversation button, preventing users from clearing the current chat session.                                                 |

***

## Widget Appearance

Click **Edit UI Setting** to customize your chatbot's appearance.

<Frame>
  <img src="https://mintcdn.com/chatzyai/qIKaZG5_O5n8nqah/ai-agents/conversational-ai-agent/settings/chat-widget2.png?fit=max&auto=format&n=qIKaZG5_O5n8nqah&q=85&s=cc6c6dc16d3dbc137797a13635174969" width="1764" height="1444" data-path="ai-agents/conversational-ai-agent/settings/chat-widget2.png" />
</Frame>

You can customize the following:

### Primary Accent Color

Choose the primary color used throughout the widget, including headers, buttons, highlights, and interactive elements.

***

### Chatbot Display Name

Specify the name displayed at the top of the chat window.

Example:

`Chat Expert`

***

### Chatbot Display Picture

Upload the avatar displayed beside the chatbot's messages throughout the conversation.

***

### Chatbot Icon

Upload the floating launcher icon shown on your website before the widget is opened.

***

## Live Preview

The right side of the **Edit UI Settings** window displays a live preview of your chatbot.

As you modify colors, names, images, or icons, the preview updates immediately, allowing you to verify your branding before saving.

Click **Save Draft** to save your widget customization.