Chatonio

This is taking longer than usual.

Chatonio

Web chat widget: choosing a launcher

October 26, 2026 2 viewsChannels & Integrations

Open the Launcher section of the Web channel settings page (Project settings → Channels → your Web channel). There are two separate choices: the button's shape or treatment, and what sits inside it. Launcher choices are independent of the widget style in Appearance: changing the window design keeps the launcher you selected. Concierge, Studio, Aura and 8-Bit can each be used with any widget style.

Launcher style is the shape:

  • AI Orb — an animated sphere in your brand colour.
  • Bubble — the round button most sites use.
  • Pill — a rounded button with a text label next to the icon.
  • Square — a rounded square.
  • Avatar — a circle showing your AI avatar image, with a small presence dot.
  • Side tab — a tab flush against the left or right edge of the window.
  • Your logo — a circle showing an image you upload for this channel.
  • Concierge — a button with a quiet shadow.
  • Studio — an outlined button with an offset shadow.
  • Aura — a button with a fine border and soft shadow.
  • 8-Bit — a square button with a pixel chat icon and a hard offset shadow.
  • No launcher — no button at all. See "No launcher" is not the same as hiding the widget on a page below.

What's inside is the icon or image: Chat, Sparkle, Headset, Dots, AI avatar, Project logo or Custom image. The last three need an image to exist first and stay greyed out until it does. The AI avatar is uploaded on the project Members page and the project logo under Workspace → Appearance; the custom launcher image has its own upload box in the Launcher section, which appears once you pick the Your logo frame or the Custom image face. It saves as soon as you choose the file rather than waiting for Save changes. Use a PNG or JPG up to 2 MB; square images work best. Anything larger than 256 pixels on its longest side is scaled down to fit, and smaller images are left as they are.

Picking Avatar or Your logo also pre-selects the matching image for you — provided that image already exists, and only while What's inside is still on Chat. A face you chose yourself is never overwritten, and a frame whose image is missing stays on the chat icon until you upload one.

Size offers Small, Medium (the default) and Large — 46, 54 and 66 pixels. Everything stacked above the button moves with it, including the collapsed message teaser and the chat window.

Options that appear for one style

With AI Orb selected, an Orb style row appears with three treatments: Aurora ring (a light ring orbiting just outside a glossy sphere), Liquid core (two soft shapes drifting inside the glass at different speeds) and Glass marble (a blurred swirl behind heavy glass with a hard specular edge). Only Aurora ring draws the orbiting outer ring. All of the motion runs continuously, and all of it is switched off for visitors whose device asks for reduced motion. The widget is also hidden when a page is printed.

With Side tab selected, a Tab placement row appears: Top, Middle (the default) or Bottom. The tab sits flush against the edge of the window, so the horizontal offset has nothing to act on and is ignored — the page shows a note to that effect. The vertical offset applies to the Top and Bottom placements as the distance from that edge. Middle is centred and ignores both offsets for the tab itself — on that placement they position the chat window and the message teaser instead. On screens 480 pixels wide and under, the side tab becomes a round button back in the corner and its label is hidden.

Launcher text appears for Pill and Side tab only, and shows only while the chat is closed. When a label is set it becomes the button's accessible name in place of "Open chat". Per-language versions of the label are edited in the Languages & translations section, not here.

The AI Orb is the default for new channels only

Web channels created since the orb shipped start on AI Orb. Existing channels were not touched. A channel set up before then still resolves to Bubble — or to Pill if it has launcher text, so a pill you configured earlier stays a pill. These launcher defaults are independent of the widget style: choosing Classic or another window design keeps your configured launcher.

"No launcher" is not the same as hiding the widget on a page

These settings look similar and behave very differently.

  • Launcher style: No launcher — the widget still loads and connects normally. Only the corner button is absent. Proactive greetings and previews of new messages still appear above the corner and still open the chat when clicked. Something on your page opens it the rest of the time; see Web chat widget: controlling the chat from your site's code.
  • Hide the launcher on these pages (in the Launcher section) — the same as No launcher, but only on the pages you list; everywhere else the button shows as usual. Use it when the button covers something on a particular page, such as the button of a form: the chat still opens from your own buttons and links there. It takes the same patterns as the URL lists.
  • Excluding a page under URLs & domains (in that section's Advanced settings) — the widget never loads on that page at all. Nothing on the page can open it, and your own button will do nothing.

With No launcher selected, if a page has no trigger of any kind, the widget writes a single message to the browser console after about three seconds naming both possible fixes. If your own button does nothing, the console usually says which of the two cases you are in. Silence from the console with no response at all points elsewhere — most often a channel that is not currently active.

In the operator's own Test Widget preview, No launcher is shown as a bubble, and pages listed under Hide the launcher on these pages keep their button, so the preview does not look broken.

Was this article helpful?