# Creating a Widget

To start creating a widget, just click on 'Create a New Widget' or the 'Create Widget' button at the top right corner.

<figure><img src="/files/B41jnLsoUiHqnBoENDNq" alt=""><figcaption><p>Lynn’s Dashboard: Create and personalize widgets on Widget creation page</p></figcaption></figure>

First, you’ll need to give your widget a name. This name is for internal use only so your team can differentiate between widgets. (Ex: Sales page widget vs. Customer support widget)

<figure><img src="/files/Gdm6oBRCcs2qXeT1qibf" alt=""><figcaption></figcaption></figure>

After you've named your widget, you'll see several fields to personalize the personality of your widget. To learn more about how to use the personality customization, please take a look at the article below.

[Personality Customization](/personality-customization.md)

Once you’ve set the personality for your widget, select “Add” to continue on to the appearance customization screen.

<figure><img src="/files/qbSTx05IKAvn7fKERV5i" alt=""><figcaption><p>Edit Widget: Customize your widgets on widget customization page (Part 1)</p></figcaption></figure>

<figure><img src="/files/RdpdfR9m7fvVAwAcam0a" alt=""><figcaption><p>Edit Widget: Customize your widgets on widget customization page (Part 2)</p></figcaption></figure>

In this section, you'll be able to customize multiple aspects of your widget including the appearance and message suggestions.

* **Widget Name:** This is where you can give your chatbot a unique name that customers will see.
* **Initial** **Message:** This is the first message users will see from your chatbot when it appears on their webpage. This field is not required.
* **Message Suggestions:** You can easily set up quick questions as suggestions that pop up instantly, helping your customers know what to ask your chatbot. This field is not mandatory.
* **Theme:** Personalize the widget's appearance by choosing a color theme. Simply click on the moon icon for a dark theme or the sun icon for a light theme, depending on what suits your style best.
* **Message Color and Widget Bubble Button Color:** Here, you can customize the colors of your chatbot's message text and bubble background. Choose colors from the color picker or enter hex codes directly to precisely match your brand colors.
* **Chat Alignment:** This option allows you to select the side of the screen where you want to Lynn to appear on your site.
* **Enable Raise for Support:** Here, you can choose whether the chat widget should show the button to raise human support or not show it at all within the widget as a button.
* **Show Knowledge Sources in Responses:** This is the option that allows you to choose whether the widget should show the reference articles used for answering the questions within Lynn's responses.

After you click '**Save Changes**', your widget will start loading. Finally, and importantly, you'll see a preview of your creation on the right side, where you can watch your chatbot comes to life.

If you’d like to test the chatbot on your site before embedding it, go ahead and use the widget preview feature which is accessible through the “Widget Preview” button in the top right corner.

<figure><img src="/files/H8a0v0DeQiT9jTnb7pRW" alt=""><figcaption></figcaption></figure>


---

# 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://support.lynn.chat/creating-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.