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

# Customise the widget

> Every setting on the widget's Appearance, Content and Behaviour tabs, and how to remove the Powered by Companion mark.

<Note>
  Owners and admins only. Others can look, but not save.
</Note>

Go to **Website chat** and open a widget. Its settings are on five tabs: **Appearance**, **Content**, **Behaviour**, **Install** and **Analytics**. The preview on the right follows what you change.

Each tab has its own **Save** button. Nothing reaches your site until you choose it, and saved changes go live within a few minutes.

## Appearance

| Setting | What it does |
| - | - |
| **Name** | The widget's name. Only your team sees it. |
| **Business name** | Shown at the top of the chat. |
| **Header picture** | The round picture beside your name, usually your logo. PNG, JPEG or WebP. |
| **Brand colour** | The colour of the button and the chat's header. |
| **Chat background** | Behind the messages: **Doodle wallpaper** or **A plain colour** of your choice. |
| **Corner** | Where the button sits: **Bottom right**, **Bottom left**, **Middle right**, **Middle left**, **Top right** or **Top left**. |
| **Button icon** | **WhatsApp logo**, **Chat mark** in your colour, or **Your own image**. |
| **Button size** | **Small**, **Medium**, **Large**, **Extra large** or **Largest**. Larger is easier to tap on a phone. |
| **Text beside the button** | Words next to the icon, such as "Chat with us". Leave it empty for the icon alone. |
| **Show on** | **Desktop and mobile**, **Mobile only** or **Desktop only**. |
| **Powered by Companion** | A small line in the chat's footer. See below. |

Pictures you upload are saved straight away, without choosing **Save**.

### Remove the Powered by Companion mark

| Plan | Can remove the mark |
| - | - |
| Free trial | No |
| Starter | No |
| Growth | Yes |
| Business | Yes |

On Growth or Business, switch **Powered by Companion** off on the **Appearance** tab. On other plans the switch cannot be changed. If you later move to a plan without it, the mark comes back by itself.

## Content

| Setting | What it does |
| - | - |
| **Welcome message** | The first thing in the chat window, before anyone writes. |
| **Out of hours** | The message shown when you are closed. |
| **Greeting bubble** | A short nudge beside the button, up to 80 characters. Switch it on or off. A visitor can dismiss it, and it stays dismissed. |
| **Greeting appears after** | How long a visitor is on the page before the greeting shows: **Straight away**, or after 5, 10, 20 or 30 seconds. |
| **Ask before the first message** | Shows a short form before a visitor can write. |

Keep messages to a line or two. They are read on a phone.

### Questions before the first message

Switch **Ask before the first message** on and choose what to ask under **The form**. Every question is off until you switch it on, and each can be marked **Required**.

* **Name**
* **WhatsApp number**
* **Email**
* **What it is about**
* Up to three questions of your own, with **Add your own question**

Each question is one more reason for a visitor to close the chat, so ask only for what you need.

## Behaviour

| Setting | What it does |
| - | - |
| **Appears after** | A delay before the button shows: **Straight away**, or after 3, 8 or 15 seconds. |
| **Reply time** | A line under your name, such as "Usually replies within an hour". |
| **Out of hours** | What happens when you are closed: **Say you are closed**, **Hide the bubble** or **Carry on as normal**. |
| **WhatsApp number** | Where **Continue on WhatsApp** goes: one of your connected numbers, or **Another number** in international format, such as +44 7700 900123. |
| **Message to start with** | Words written into WhatsApp for the visitor, ready to send. |

### Where a conversation goes

Both choices keep the chat in your inbox. This decides how strongly the widget offers WhatsApp.

* **Move it to WhatsApp**: offers WhatsApp throughout the chat.
* **Keep it on the site**: WhatsApp stays a small link in the footer.

### Opening hours

Choose **Always open** or **Set hours**. A new widget is always open, so the out of hours message is never shown until you set hours.

With **Set hours**, pick a time zone and the hours for each day. The hours are in that time zone wherever the visitor is, and can run past midnight. Outside them, the widget does what **Out of hours** says.

### Which pages show it

* **Every page**: the chat shows on every page of the sites it is allowed on.
* **Only these pages**: it shows on the paths you list.
* **Not on these pages**: it shows everywhere except the paths you list, which is useful for a checkout.

A path is the part of the address after your domain, such as `/contact`. End it with a star to cover everything beneath it: `/products/*` covers every product page. You can list up to 50 paths.

## Install and Analytics

The **Install** tab holds the sites the widget may appear on, the snippet and the check that it is live. See [Install the widget](/website-chat/install).

The **Analytics** tab shows, for the last 7, 30 or 90 days, how many visitors saw the button, opened the chat, started a conversation and moved to WhatsApp. It also shows your average first reply time, the pages and devices that start conversations, and **Export conversations as CSV**.

## A Shopify store's chat button

A widget created by the Shopify app opens WhatsApp with the shopper's message and has no on-site chat window. Settings that only a chat window uses are left out for it: the out of hours message and behaviour, the questions before the first message, the message to start with, where a conversation goes, and opening hours.

## Related

* [Install the widget](/website-chat/install)
* [Website chat overview](/website-chat/overview)
* [The Shopify app](/website-chat/shopify-app)
* [Plans](/billing/plans)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.