The widget’s visual appearance is configured in the Design section of your project dashboard. Changes take effect immediately for new page loads (the widget config is fetched on initAsync).
Appearance settings
| Setting | Default | Options |
|---|
| Color scheme | dark | light, dark |
| Position | bottom-right | bottom-right, bottom-left |
| Border radius | 12px | Any number |
| Panel width | 420px | Any number |
| Show branding | true | true, false |
Color scheme
The widget supports light and dark themes. The color scheme affects the chat panel background, text colors, and message bubbles.
{
"colorScheme": "dark"
}
Position
Control where the chat bubble appears on the page:
- bottom-right — default, suits most layouts
- bottom-left — use when the bottom-right conflicts with other UI elements
Branding
When showBranding is enabled, the widget displays a small “Powered by Agentic Trust” badge. Disable it for a white-label experience.
The widget fetches its configuration from GET /api/v1/widget/config on initialization. The response includes all design settings plus available workflows (skills):
{
"showBranding": true,
"colorScheme": "dark",
"position": "bottom-right",
"borderRadius": 12,
"panelWidth": 420,
"availableSkills": [
{
"id": "wf_abc123",
"name": "Refund Request",
"description": "Process a refund for an order"
}
]
}
Use initAsync instead of init to ensure the widget picks up your dashboard configuration. With init, the widget renders with hardcoded defaults.
