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

# Design your widget

> This file explains how to style and customise every visual element of your widget so it matches your brand, from headers and colours to message bubbles, fonts and launcher options.

Under design you can style your Widget to fully match your brand. For a quick start, select a **Template** or choose **Custom** **Template** to manually set your preferences.

<Frame>
  <img src="https://mintcdn.com/watermelon/bhmQYsmauHtUWN4i/images/publish-your-agent/customize-your-widget/design/design-template.png?fit=max&auto=format&n=bhmQYsmauHtUWN4i&q=85&s=168fb68a49a8afeec54908e5dc58d432" alt="Design Template" width="2922" height="1390" data-path="images/publish-your-agent/customize-your-widget/design/design-template.png" />
</Frame>

<Info>
  **Note: keep your widget WCAG-proof**\
  It’s important that your widget remains accessible for everyone. Keep an eye on the following points when making changes:\
  • Make sure all text has sufficient color contrast with the background.\
  • Avoid gifs that are too fast or distracting.
</Info>

### Your header

Change the header of your Widget here. You can either choose to add text, or add an image e.g. your logo. If you choose to upload your own image, this should be a PNG, JPG or GIF file. We recommend uploading an image that is 116x692 pixels with a maximum size of 5MB.

<Frame>
  <img src="https://mintcdn.com/watermelon/bhmQYsmauHtUWN4i/images/publish-your-agent/customize-your-widget/design/design-header.png?fit=max&auto=format&n=bhmQYsmauHtUWN4i&q=85&s=e5558147118f73be32822f990fc32b2e" alt="Design Header" width="2922" height="1390" data-path="images/publish-your-agent/customize-your-widget/design/design-header.png" />
</Frame>

### Your brand avatar

Your brand avatar will be shown when there is no AI Agent active on your chat widget, and the conversation hasn't been assigned to an agent. The avatar should be a PNG, JPG or GIF file. We recommend uploading an image that is 500x500 pixels with a maximum size of 1MB.

<Frame>
  <img src="https://mintcdn.com/watermelon/bhmQYsmauHtUWN4i/images/publish-your-agent/customize-your-widget/design/design-brand-avatar.png?fit=max&auto=format&n=bhmQYsmauHtUWN4i&q=85&s=bbd6554a70dfcf0165870dc54ad28a61" alt="Design Brand Avatar" width="2922" height="1390" data-path="images/publish-your-agent/customize-your-widget/design/design-brand-avatar.png" />
</Frame>

### Widget design

In the Widget design section, you can change the colours of your widget. Click on the colour to select a colour, or add your colour code. You can add your colour code in HEX, RGB of HSL.

<Frame>
  <img src="https://mintcdn.com/watermelon/kN06oflwkEa6UlTv/images/design-widget-colour.png?fit=max&auto=format&n=kN06oflwkEa6UlTv&q=85&s=663cfa0ae1512ee158ee3d2c4a2ebdfd" alt="Design Widget Colour" width="2880" height="1460" data-path="images/design-widget-colour.png" />
</Frame>

### Chat element colours

The Chat element is the element in the middle of your Welcome/Closed screen. You can change the background and outline colours by clicking on the colour code.

<Frame>
  <img src="https://mintcdn.com/watermelon/bhmQYsmauHtUWN4i/images/publish-your-agent/customize-your-widget/design/design-chat-element-colours.png?fit=max&auto=format&n=bhmQYsmauHtUWN4i&q=85&s=752513b41b6cc65a1e225be0e4a71e83" alt="Design Chat Element Colours" width="2922" height="1390" data-path="images/publish-your-agent/customize-your-widget/design/design-chat-element-colours.png" />
</Frame>

### Users in welcome screen

Here, you can specify which users you want visible in the welcome screen when no AI Agent is active.

* **Select users**: manually choose which user you want to display.
* **Automatic:** the users will randomly be picked.

<Frame>
  <img src="https://mintcdn.com/watermelon/bhmQYsmauHtUWN4i/images/publish-your-agent/customize-your-widget/design/design-users-in-welcome-screen.png?fit=max&auto=format&n=bhmQYsmauHtUWN4i&q=85&s=4ea595851fdf04d45262244713e88c83" alt="Design Users In Welcome Screen" width="2922" height="1390" data-path="images/publish-your-agent/customize-your-widget/design/design-users-in-welcome-screen.png" />
</Frame>

### Customise messages bubbles

Under Customise message bubbles, you can choose how your message bubbles will look like. Choose **Default** for **standard** settings. In the **Conversations** preview on the right, you can see the changes you're making.

* **Default:** When choosing default, all bubbles will have standard styling.
* **Custom:** When you choose **Custom**, you can change the **message shape** and **colours** of the message bubbles for all users. Select **AI Agent/User**, **User** or **End-user** and style as per below:
  * **Message background**:Here you can change the background colour of the message bubble. It is recommended to have different colours for the Agent, User and End-user so it is clear who sent which message.
  * **Outline**:The outline color defines the edge of the bubble. Adjust it to help the message bubble stand out more clearly against the background.
  * **Font colour**: The font colour is the colour of the text in the message bubble. Choose a colour which stands out from the background for good readability.
  * **Corner radius 4x**:Corner radius is the measurement that determines how rounded the corners of a shape are. A higher corner radius makes the corners look softer and more curved, while a lower radius keeps them sharper and more square. Amend all corners as you wish.

<Frame>
  <img src="https://mintcdn.com/watermelon/bhmQYsmauHtUWN4i/images/publish-your-agent/customize-your-widget/design/design-customize-message-bubbles.png?fit=max&auto=format&n=bhmQYsmauHtUWN4i&q=85&s=2fa97fbbea13036b60a53fe5d3fcce76" alt="Design Customize Message Bubbles" width="2922" height="1390" data-path="images/publish-your-agent/customize-your-widget/design/design-customize-message-bubbles.png" />
</Frame>

<Tip>
  You can change all texts in the Chat Widget such as "Is typing" and "AI Agent".

  Go to the **Localize** tab and set the language to **Custom**. Change the text under **Text in conversation screen**.
</Tip>

### Font settings

Open the **Conversation** or **Welcome** tab in the preview on the right.

* **Select your font**: Choose the font of your branding, or a similar font to blend in with your company style. Choose a contradicting font to make your Chat Widget stand out more.
* **Header font size**: The header is the top text on your Welcome screen. By changing the font size, you fit a larger header.
* **Message font size**: This is the size of the text in the chat screen. Choose a size which fits your company style.

<Frame>
  <img src="https://mintcdn.com/watermelon/bhmQYsmauHtUWN4i/images/publish-your-agent/customize-your-widget/design/design-font-settings.png?fit=max&auto=format&n=bhmQYsmauHtUWN4i&q=85&s=2cb8107382f0894223deaf0e831a1546" alt="Design Font Settings" width="2922" height="1390" data-path="images/publish-your-agent/customize-your-widget/design/design-font-settings.png" />
</Frame>

### Launcher

The launcher is what shows on your website when your Agent is minimized. By clicking this, the widget will open. You can choose between:

* **Icon:** Use the default icon, or upload your own icon by clicking **Upload**. \
  The icon should be a PNG, JPG or GIF file. We recommend uploading an image that is 64x64 pixels with a maximum size of 5MB.
* **Entire button:** Choose entire button to upload your own image as the launcher by clicking **Upload.** The custom launcher should be a PNG, JPG or GIF file. We recommend uploading an image that is 112x112 pixels with a maximum size of 5MB.

  <Note>
    Entire button is only available in Business and Enterprise licenses.
  </Note>

#### **Colours of launcher**

Here you can change the colours of the launcher. We recommend opening **Minimized** in the preview screen on the right, so you can see your changes immediately.

* **Icon main colour**: This is the colour of the strips of the icon of the launcher and the text of the eye-catcher.
* **Icon background colour**: Here you can set the background colour of the **Icon**. It's recommended to use a striking colour so the Widget will stand out on the website.
* **Close icon mail colour**: When the Chat Widget is open, the stripe icon will change into an arrow down. Choose a colour for the arrow.
* **Close icon background colour**: Choose a colour for the background of the icon for when the Widget is open.

<Frame>
  <img src="https://mintcdn.com/watermelon/bhmQYsmauHtUWN4i/images/publish-your-agent/customize-your-widget/design/design-launcher-settings.png?fit=max&auto=format&n=bhmQYsmauHtUWN4i&q=85&s=1df89ea22118a9a13ddcb310a2e09d05" alt="Design Launcher Settings" width="2922" height="1390" data-path="images/publish-your-agent/customize-your-widget/design/design-launcher-settings.png" />
</Frame>

<Warning>
  Don't forget to save your changes by clicking **Save** on the top of your screen
</Warning>
