Widget customization
Widget customization
Set the widget's text, colors, launcher, behavior, and languages, with a live preview of what customers will see.
Everything about how the Chat widget reads, looks, and acts lives at Channels → Chat widget, in three tabs: Content, Style, and Behavior. The right side of the page is a live preview of the widget on your site, with a Desktop and Mobile switch.
Brand settings are shared with Spotlight and the Chat Page; content is per channel. The table at the end shows which is which.
New widgets start with a neutral white primary color. Onboarding and connecting Shopify switch it to your brand color when they find one, as long as you haven't picked a color yourself.
Customize the widget
Each tab is a list of sections. Opening a Content section moves the preview to the matching view.
The preview updates as you type. Switch it to Mobile to check the phone layout.
A save bar appears whenever you have unsaved changes, and they survive switching tabs. Saved changes reach your site on the next page load.
Content
Every piece of text a visitor reads, grouped by where it appears.
| Section | Settings |
|---|---|
| Home screen | Widget Name (required); Header Text — the title in the chat header, your workspace name when empty; Home headline and Home subheadline; the Welcome Card — Show Welcome Card, Card Title, Card Subtitle ("Ask a question" and "AI Agent and team can help" by default); Spaces — Add spaces chooses which views visitors can reach (Home and Messages) |
| Conversation | Chat opening message — the first message the AI sends; Conversation starters — up to 5 click-to-send prompts, drag to reorder, with Keep showing after first message; Message Input Placeholder; Footer & disclaimer — Footer Text (for example a reply-time note), a Dismissible Notice shown once at the top of the chat, and Privacy policy URL — your store's privacy policy; when set, "By chatting, you agree to our Privacy Policy" appears below the message box and links it, and when empty there's no line. Bare domains get https:// added. |
| Launcher teaser | Show teaser bubble next to the closed launcher, its Teaser Text (empty reuses the opening message), and a Delay (seconds) after page load |
Style
| Section | Settings |
|---|---|
| Theme & color | Color theme — Light, Dark, or Custom Premium, kept whatever the visitor's device setting. Custom adds per-token colors for surfaces, text, accent text, and inputs, with a warning below the WCAG AA contrast ratio of 4.5:1. Primary color — buttons, your messages, links, and active tabs; when it blends into the chat background (white on Light), those use the theme's text color. Use primary color for header adds a soft wash of it behind the Home header. |
| Brand | Profile Picture — upload JPG, PNG, or SVG up to 1MB, Use workspace logo (the default), or Remove to show the Asks mark. Show Branding and Remove Asks branding Premium control the "Powered by Asks" mark; on other plans the Remove Asks branding add-on hides it. |
| Launcher | Always your primary color. Launcher icon — the Asks mark (default), Chat bubble, Chat dots, Sparkle, Headset, or Upload your own (square PNG or SVG, transparent background, up to 1MB). Show text in the launcher makes it a pill with your Launcher text (up to 40 characters) and an Icon position. Size — Small, Input only, or Classic. Position — Right or Left. |
| Shape & type | Roundness (S, M, L, Full) and Text size (Small, Medium, Large). |
| Window size | Max width 320–640px (400 by default) and Max height 400–800px (704 by default). The window opens above the launcher and shrinks on short screens rather than covering it. |
Behavior
| Group | Settings |
|---|---|
| Engagement | Auto-open the widget on page load, with an Auto-open delay (seconds). |
| Chat experience | Show typing indicator while a reply is being written. Allow file uploads, with a Max file size (MB) — 10 by default, up to 10 files per message. |
| Feedback | End-of-chat ratings are a workspace setting, on the Ratings analytics page; one toggle covers the Chat widget, the Chat Page, and the email sent when a conversation is resolved. See Ratings & CSAT. |
Localization
The Behavior tab also has Localization: the language of the widget's own text — buttons, labels, timestamps, and system messages. Use Add language and Set as default to choose from English, Spanish, Portuguese, French, German, Italian, Dutch, and Indonesian. A visitor whose browser language matches one you've added sees it; everyone else sees your default. Your own content — opening message, starters, titles — is never machine-translated. The setting covers every website channel.
What each website channel uses
| Setting | Chat widget | Spotlight | Chat Page |
|---|---|---|---|
| Content tab | Its own | Its own; footer and notice shared with the Chat widget | Its own |
| Privacy policy URL | Shared — edit it on any channel's Content tab | Shared | Shared |
| Theme | Light, Dark, or Custom | Composer color, Light or Dark — the same setting | Light, Dark, or Custom |
| Primary color, brand, shape and type | Shared | Shared | Shared |
| Launcher, teaser, window size, header color | Chat widget only | — | — |
| File uploads, typing indicator, languages | Behavior tab | Follows the Chat widget | Follows the Chat widget |
| Auto-open | Behavior tab | Follows the Chat widget | — |
Related
- Chat widget — turn it on and install it on your site.
- Spotlight and Chat Page — the other website channels that share this style.
- Ratings & CSAT — the workspace rating setting and where ratings land.