Customise the chat widget

The chat widget’s settings are on Agents → your agent → Channels › Website chat, in the Widget tab. On the left are the settings, in three tabs: Content, Style and Launcher. On the right is a live preview of the chat panel, What visitors see, drawn from your unsaved changes as you type. Saved changes go live on your site without touching the embed snippet. Owners and admins can save changes. The agent’s name, instructions and tools aren’t here. The name is on Settings, and the instructions and tools are on Instructions. See instructions. The phone greeting is on Channels › Phone, and chat doesn’t use it.

The live preview

The preview on the right is the same panel your visitors get.

Real replies: when the chat channel is on, the preview talks to your saved agent. These chats are real conversations: they show up in Conversations and count as usage. With chat off, replies in the preview are canned.
Saved agent: the look follows your edits as you type, but replies come from the saved agent. After changing the agent’s instructions, save them on Instructions, then ask again.
Reset throws away the preview conversation and starts over.
Full page opens the chat on its own page in a new tab.

To try the agent from any page, or to talk to it by voice, use Preview at the top of the agent’s pages. See test your agent. When you have unsaved changes, a bar at the bottom says “You have unsaved changes.” with Discard and Save changes. Switching tabs keeps your edits.

Content tab

What the panel says.

Setting	Default	Notes
Icon	None	Use website icon takes your site’s favicon, or Upload your own PNG, JPEG, GIF, WebP or AVIF under 5 MB. It’s resized to 256 px and served in the best format each visitor’s browser supports. SVG isn’t accepted. Remove clears it.
Header name	The agent’s name	Up to 60 characters.
Tagline	Empty	Shown under the name before the conversation starts. Up to 120 characters.
Opening message	”Hi! How can I help you today?”	The first message a visitor sees. Leave empty to use the default. It never falls back to the phone greeting. Line breaks, `bold` and `- bullets` render. Up to 500 characters.
Input placeholder	”Type a message…”	Up to 80 characters.
Suggested questions	None	One-tap questions shown until the visitor says something. Up to five. Click Add question to add one.
Suggest follow-ups	Off	After each reply, the agent offers two or three short next questions as buttons. When it has just asked the visitor something, they are the likely answers instead (“Yes, please”). They are written in the conversation’s language, only for things the agent can answer, and skipped while it is collecting details or a person has been asked for. A tapped one is billed like a typed message.
Answer ratings	Off	Thumbs up and down under each of the agent’s replies. A visitor can change or take back their rating. In Conversations, filter by Thumbs down to find the answers that missed, and open one to see which reply was rated.
Voice typing	On	A mic in the message box. The visitor speaks, the words appear in the box, and they send it like a typed message, so it costs the same as a typed reply. It uses the browser’s own speech-to-text, so it only shows in browsers that have it: Chrome, Edge and Safari, not Firefox.
Disclaimer or footer note	Empty	Small print under the message box, such as “Answers are AI-generated and may be wrong.” One link is allowed, written `[privacy policy](https://yoursite.com/privacy)`. Up to 240 characters.

Style tab

How the panel looks.

Setting	Default	Options
Theme	Light	Light or Dark shows that to every visitor. Auto follows each visitor’s device: dark for someone with dark mode on, light otherwise, and it switches if they change it mid-chat. The preview follows your own device.
Accent colour	`#111111`	Any hex colour. Used for the visitor’s messages.
Accent the header	Off	Fills the header with the accent colour.
Accent the send button	On	Fills the send button with the accent colour.
Typeface	Inter	Inter, System, Geist, Figtree, Nunito, Roboto, Open Sans, Lato, Poppins, Montserrat, Arial, Helvetica, Georgia, Times New Roman.
Text size	16px	12, 13, 14, 15, 16, 17, 18 or 20px. Everything in the panel scales with it.
Corners	Medium	None (0px), small (6px), medium (12px) or large (20px).

Text on an accent-coloured header, and on the launcher, switches between white and near-black automatically so it stays readable on whatever colour you pick.

Keep text at 16px or above if many visitors are on phones. Below 16px, iPhones zoom the page when someone taps the message box.

Launcher tab

The button that opens the chat, and where the panel sits.

Setting	Default	Range and notes
Launcher colour	`#111111`	Any hex colour.
Label	Empty	Text on the launcher, like “Chat with us”. Leave empty for a round launcher. Up to 40 characters.
Panel size	Standard	Compact (360 × 560px), standard (375 × 725px) or tall (400 × 800px).
Side of the page	Right	Left or right.
Open by itself after	0 seconds	0–120 seconds. 0 leaves it closed until clicked. It opens by itself once per browser tab.
Distance from the edge	24 × 24px	From the side, then from the bottom. 0–200px each. Raise it to clear a cookie bar or a sticky footer.
Full screen on phones	On	On screens under 480px wide, the open panel fills the screen. Off keeps it a floating card, which is cramped at that size.
Hide on phones	Off	No launcher at all on screens under 480px wide.
Stacking order	2147483000	0–2147483647. Lower it so an overlay of your own, such as a cookie banner or checkout, sits on top of the widget.

Save and publish

Click Save changes. When the look or wording of the widget changed, you’ll see “Saved — live on your site within a minute.” Visitors get the new look on their next page load; there’s nothing to change in the snippet. If the widget is still on its defaults, the page says so under the settings.

Different settings on one page

Everything here applies wherever the widget is installed. To change the side, colour, label, offsets, stacking order, mobile behaviour or auto-open on a single page, override it on the script tag or in window.wiredeskSettings. See widget settings.

Get started

Concepts

Agents

Knowledge

Instructions

Actions

Handoff

Integrations

Channels

Chat widget

Your workspace

Account and billing

Reference

Troubleshooting

Customise the chat widget

The live preview

Content tab

Style tab

Launcher tab

Save and publish

Different settings on one page

​The live preview

​Content tab

​Style tab

​Launcher tab

​Save and publish

​Different settings on one page

​Related

The live preview

Content tab

Style tab

Launcher tab

Save and publish

Different settings on one page

Related