Theme
Admin Panel
The widget's appearance and behaviour are configured in the admin panel, not in the embed code. That way you can update settings such as color, position, call features, or member login without changing any code.
All of the settings below live in the provider editor.
Widget Theme
| Setting | Values | Description |
|---|---|---|
| Theme | layout variant | The widget's layout variant. |
| Dark Mode | Light · Dark · Auto | Light, dark, or follow the visitor's system preference. |
| Brand Color | color | The accent color used throughout the widget. |
Widget Placement
| Setting | Values | Default | Description |
|---|---|---|---|
| Widget Position | Bottom Right · Bottom Left · Top Right · Top Left | Bottom Right | Which corner the widget sits in. |
| Horizontal Offset | 0–200 px | 24 | Distance from that corner, horizontally. |
| Vertical Offset | 0–200 px | 24 | Distance from that corner, vertically. |
| Horizontal Offset (Mobile) | 0–200 px | — | Used on small screens instead of the value above. |
| Vertical Offset (Mobile) | 0–200 px | — | Used on small screens instead of the value above. |
Leave a mobile offset empty and the desktop value applies on every screen size.
Call settings
The Webfon section manages the call features. Two settings let the agent request media from the visitor during a call:
| Setting | Default | Description |
|---|---|---|
| Agent Camera Request | off | The agent can ask the visitor to turn on their camera. Requires the customer video feature to be enabled. |
| Agent Screen Share Request | off | The agent can ask the visitor to share their screen. Requires the customer screen-share feature to be enabled. |
Visitor consent is required
The request opens a confirmation dialog in the visitor's widget (Allow / Decline). If no answer arrives within 30 seconds, the request is automatically declined. No media is turned on without the visitor's approval; if they approve, it flows exactly as if the visitor had started it themselves. If the corresponding customer feature is off, the request setting is disabled as well.
Member Login
The Member Login section manages the social login options in the widget (see Authentication):
- Key Source —
Webfon Application Keys(Webfon's OAuth applications) orOwn Application Keys(your own OAuth applications). - An enable checkbox per provider — only enabled providers appear on the widget's login page.
- When Key Source is
Own Application Keys, a Client ID / Client Secret per provider; for Apple additionally Team ID / Key ID and the p8 private key.
Supported providers: Google, Facebook, Apple, GitHub, X.
When do updates take effect?
A change in the admin panel reaches the widget within about a minute at most — widgets already open on a page pick it up on their next load.