Skip to main content
The Agent → Appearance tab is where you make the Agent feel like it belongs in your product — colors, layout, welcome message, and personalization tokens. No code changes, no deploys.

​
Where to configure

Open your dashboard and go to Agent → Appearance. The tab is split into three sub-sections: Every change is staged as a draft. Use the Test tab to preview your changes, then publish from any Agent tab when you’re ready.

​
Configuration options

​
Personalization tokens

Welcome messages can use these tokens: Example:

​
Color scheme behavior

The widget is fully isolated from your page styles, so your CSS won’t accidentally change how the Agent looks. You control its appearance entirely from the dashboard.

​
Position presets

If your product has a fixed bottom bar, increase Bottom spacing so the launcher clears it. Upload SVG (preferred) or PNG variants for light and dark modes. The widget swaps automatically based on the active color scheme. Recommended size: 32×32 pixels. SVGs are preferred because they stay sharp on any screen.

​
Localization

The welcome message and placeholder are stored as plain strings — set them to your primary language. Agent answers themselves are generated in the language of the user’s question; no manual translation step required.

​
Hiding the Agent

There are three ways:
  1. Per-user, runtime — call HelpAlive.setConsent({ chat: false }).
  2. Per-tenant — disable the Agent for specific workspaces from Insight → Audience.
  3. Globally — turn off the Agent from Agent → Configuration.
Hiding takes effect immediately; no page reload required.

​
Next steps

Train on your docs

Add your first knowledge source.

Publishing workflow

Stage and preview before going live.