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

# Creating a Widget

> How to create a widget key for your assistant and choose the right mode for your website.

Creating a widget is a quick process. You pick an assistant, choose a mode, and VozAgent generates the widget key and embed code for you. This article walks through each step.

***

## Before You Start

You'll need two things before creating a widget:

1. **An active assistant** -- Widgets are powered by your existing VozAgent assistants. If you don't have one yet, head to **Assistants** and create one first.
2. **A Growth plan or higher** -- Widgets are available starting on the Growth plan. If you're on a lower tier, you'll see an Upgrade button instead of the Create option.

Only **admin users** can create widget keys. If you don't see the Create button and you're on a Growth plan or above, check with your organization admin.

***

## Step 1: Go to the Widgets Page

Navigate to **Widgets** in your dashboard sidebar. You'll see a list of all your active assistants. Each card shows the assistant's name and whether a widget key already exists for it.

***

## Step 2: Click Create

Find the assistant you want to embed on your website and click the **Create** button on its card. VozAgent will generate a widget key in **Chat & Voice** mode by default, which gives your visitors both text and voice interaction options.

The widget key is created immediately, and you'll see a success message confirming it.

***

## Step 3: Open the Widget Detail View

Once the key is created, the assistant card will update to show:

* A **mode badge** (Chat & Voice, Chat, or Voice)
* The first 12 characters of the **widget key**

Click on the card to open the widget detail view, where you can customize the appearance, behavior, and embed code.

***

## Understanding Widget Modes

When a widget key is created, it defaults to **Chat & Voice** mode. Here's what each mode means for your visitors:

### Chat Mode

Visitors interact through text messages only. This is the best choice if:

* You want a simple, quiet experience for visitors
* Your website audience prefers typing over talking
* You want to avoid microphone permission prompts in the browser

### Voice Mode

Visitors interact through their browser microphone. This works well if:

* You want a phone-like experience on your website
* Your assistant is primarily optimized for voice conversations
* You want visitors to have a hands-free option

### Chat & Voice Mode

Visitors can choose either text or voice. This is the most flexible option and is the default because it lets each visitor pick their preferred method.

***

## One Widget Per Assistant

Each assistant can have only one widget key at a time. If you need to change the configuration, you can edit the existing widget rather than creating a new one. If you want a completely fresh start, you can delete the existing widget key and create a new one -- but keep in mind that deleting a key immediately disables any embed code using that key.

***

## What Happens Next

After creating your widget key, you'll want to:

1. **Customize the appearance** -- Set the display name, accent color, avatar, and greeting message
2. **Configure behavior** -- Choose a primary goal (lead capture or support) and set up intake questions
3. **Install the embed code** -- Copy the code snippet and paste it into your website

All of these are covered in the next article.

***

## Related Articles

* [Widgets Overview](/help/widgets/widgets-overview)
* [Installing and Customizing Your Widget](/help/widgets/installing-and-customizing)
* [Creating an Inbound Assistant](/help/assistants/creating-an-inbound-assistant)