# Configure a Widget

In Website Embed, select the widget from the list and select **Configure** to open the widget Overview page.

<div align="center" data-with-frame="true"><img src="/files/5293ef1a10b1468ae1a9ecfee0c28ef6dc25c542" alt="" width="375"></div>

On this page, key stats include total conversations, total messages, and average session duration.

<div data-with-frame="true"><figure><img src="/files/diWbHundoZPamvN7Ct7K" alt=""><figcaption></figcaption></figure></div>

This page also shows the widget’s current configuration, including appearance and settings.

<div data-with-frame="true"><figure><img src="/files/KA35H5emeoddC0jSHb8N" alt=""><figcaption></figcaption></figure></div>

{% hint style="info" %}
Please note that the toggle switch is located in the top-right corner of the Overview page. Use it to enable or disable the widget.

![](/files/38hIUjAouIgxhGUnxJko)
{% endhint %}

## Widget Management

If changes are needed, select **Manage Widget** in the top-right corner. The Manage page uses the same setup flow as [Add a Widget](/chatlyst-user-guide/inbound-channels/website-embed/add-a-widget.md).&#x20;

<div data-with-frame="true"><img src="/files/996900b54d88e15860b5e93f8fdffe37787e3290" alt=""></div>

{% hint style="info" %}
Navigation tab — use this to return to the Overview page at any time. Before leaving the page, select **Save** and confirm the toggle is set correctly so changes are not lost.

![](/files/RwL52EYq6kpLkODruJl0)
{% endhint %}

{% hint style="info" %}
Please note that the toggle switch and Save button are located in the top-right corner of the management page. Select **Save** after making changes and confirm the toggle is set correctly so updates are applied.

![](/files/JQ08gUjRqxUrnKVKA9ef)
{% endhint %}

### Embed code

At the bottom of the widget Overview page, copy the embed code and paste it into the website to install the widget.

Basic example of embedding code on a website:

```html
<body><h1>My Website</h1><p>Welcome to my site.</p>

<!\-\- Paste widget code here --!>
</body>
```

<div data-with-frame="true"><figure><img src="/files/JXtVBenkG5X9pV1Lijg6" alt=""><figcaption></figcaption></figure></div>

### Preview Widget

{% stepper %}
{% step %}
Select **Preview Widget** to open a live example of how the widget looks and behaves when embedded on a website.

<div><figure><img src="/files/zmeQfSDNLAiuZI0zH9f7" alt=""><figcaption></figcaption></figure> <figure><img src="/files/rmIWI77bASrW48YjtMPb" alt=""><figcaption><p>Preview Widget</p></figcaption></figure></div>
{% endstep %}

{% step %}
Test the widget as a website visitor by selecting the launcher icon to open the conversation window and start chatting with the bot.

<div data-with-frame="true"><figure><img src="/files/fraOleKl41P2Y27bhnWv" alt=""><figcaption></figcaption></figure></div>

{% hint style="info" %}
The embed code is still available to copy and test on a website before going live.

![](/files/xyuDvg1mwzHrq1aDPalA)
{% endhint %}
{% endstep %}

{% step %}
Review the widget appearance, including colors, widget name, and welcome message, and verify that it aligns with your settings.

<div data-with-frame="true"><figure><img src="/files/0JPr62AuC34TKvjWj6VQ" alt=""><figcaption></figcaption></figure></div>
{% endstep %}

{% step %}
Send a few test messages to confirm the overall experience displays correctly.

{% hint style="warning" %}
**Important Note**: Messages sent in the preview are live and are recorded as real conversations. Conversations created in the preview appear in Chat the same way as any other visitor conversation.
{% endhint %}

<div data-with-frame="true"><figure><img src="/files/WmJseNZMdmx0amIg8XDI" alt=""><figcaption></figcaption></figure></div>
{% endstep %}
{% endstepper %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://chatlyst.gitbook.io/chatlyst-user-guide/inbound-channels/website-embed/configure-a-widget.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
