Customizing your chat widget

You customize the Deskwoot chat widget under Settings > Inboxes. Open your website inbox, click Configuration, and every option below lives in that panel. Changes save to the inbox and show up in the widget the next time it loads, so you can keep a tab open on your site to check your work.

How do I change the widget color and theme?

Set the brand color to match your site. That one color drives the launcher button, the header, and the agent message bubbles, so picking the right hex value does most of the visual work. If you leave it blank, the widget falls back to your account brand color from Account settings, and then to Deskwoot blue.

You also pick a theme: light (the default) or dark. Dark is handy when your site is dark and a bright white panel would clash. There is a separate background color field if you want to fine-tune the surface behind the conversation.

Choose where the launcher sits with the position setting: bottom-right or bottom-left.

What languages does the widget speak?

By default the widget is set to auto, which means it reads the visitor's browser and page language and renders its built-in labels (buttons, placeholders, status text) in that language. Deskwoot ships those labels in 10 locales: English, German, Portuguese (Brazil), Hindi, Arabic, Italian, French, Spanish, Japanese, and Chinese. Arabic also flips the layout to right-to-left.

If you serve one audience and want to lock the widget to a single language regardless of the visitor's browser, change Widget language from auto to that locale.

Auto-detect only covers the fixed interface strings. Your own welcome text and greeting are separate. You can translate those into any of the 10 locales in the same settings, and the widget serves the version that matches the visitor.

How do I set the launcher title and welcome message?

The launcher title is the short tooltip that appears next to the floating button, for example "Chat with us". Keep it to a few words.

The welcome message is the heading and tagline a visitor sees the moment they open the widget. Write a real greeting that sets expectations, something like "Hi there! We usually reply within a few minutes." You can also set a greeting that arrives as a first message in the conversation, and a separate out of office message for visitors who open the widget outside your business hours.

The reply time setting controls the small "we typically reply in..." line so visitors know what to expect before they type.

Can I hide the chat bubble?

Yes. Turn on hide bubble and the floating launcher disappears from your site. Use this when you want to open the widget from your own button or link instead of the default bubble. Your site code calls the widget open method, and the conversation panel slides in without the bubble ever showing.

On the Enterprise plan you can also hide the "Powered by Deskwoot" badge in the widget footer. That toggle is separate from the help center white-label switch. See White-label your help center for the help center side of it.

How do I set a custom avatar?

Every incoming message in the widget shows an avatar. By default it uses your company logo, which you upload in Account settings. If you want the inbox to have its own face instead, turn on use inbox avatar and upload an image for that inbox. This is useful when one team has its own branding, or when you want a friendly photo rather than a logo on chat replies.

Can I show help articles in the widget?

Yes, if you have a help center connected to the account. The widget has a Help Center tab, and the Conversation tab can show a short "Suggested" rail of featured articles. You have two ways to fill it. Curate it by picking specific articles (up to 4, in the order you choose), or leave it on random and the widget pulls 4 published articles for you. Random is the default when you have a help center but haven't picked anything yet. Only published articles ever appear, so a draft can't leak into the widget.

What is cookieless mode?

Turn on cookieless mode and the widget stops writing its session cookie to the visitor's browser. This helps if your privacy or cookie-consent rules don't allow non-essential cookies before a visitor opts in. The tradeoff: without the cookie, the widget can't recognize a returning visitor across page reloads or visits, so each session starts fresh. Leave it off if you want conversation continuity across page loads, turn it on if your compliance posture needs it.

Pre-chat forms, file upload, and emoji

Turn on the pre-chat form to collect a name, email, phone, or custom fields before a conversation starts. It helps you recognize returning customers and follow up by email if the visitor leaves. The file upload button lets visitors share screenshots and documents, and the emoji picker lets them add emoji to messages. Both are on by default and can be switched off in the same panel.

Proactive chat triggers

Chat triggers are messages that pop up on their own based on rules you set, for example after 10 seconds on the pricing page. They are configured per inbox in the same Configuration panel. You set a time delay, target specific pages, and write the message. Triggers are a good way to start a conversation before the visitor goes looking for the bubble.