AgentStack Docs

Customize widget appearance

Configure the widget theme, launcher, greeting, automatic opening, and legal links with a live preview.

Open Settings → Appearance to customize the external chat widget for one agent. Changes require agent-edit access. The page includes a live preview with greeting, launcher, and chat-open states, so use it to assess the customer experience before saving.

Choose the base presentation

Select Light, Dark, or System theme and place the launcher on the Left or Right. These settings affect the widget served to an eligible public customer surface, not the authenticated dashboard Playground.

Use the floating greeting carefully

The optional floating greeting is a whole-pill opener for the chat. It can contain up to 200 characters. Set it to appear after one through 30 seconds and to auto-hide after three through 60 seconds. It has no separate reply or dismiss action, so keep the message short and avoid presenting it as a completed support response.

You can also configure automatic opening of the chat with a delay from zero through 60 seconds. Test it on the target site: an aggressive auto-open can be useful on a support page and distracting on a marketing page.

Enter a valid Privacy Policy / Terms URL when your widget needs it. When present, the widget shows a dismissible link above the chat input. Invalid URLs are rejected rather than saved.

Select Save Changes after checking the preview. Appearance does not replace Allowed Domains or Geographic Access; those settings determine whether a public visitor can load the widget at all.

On this page