Widget configuration

You configure the widget with data-* attributes on the script tag. Here’s the full set.

Core attributes

• data-key — your publishable key (pk_test_… or pk_live_…). Required.
• data-position — launcher corner: bottom-right (default), bottom-left, top-right, or top-left.
• data-locale — a language hint (for example ar or en-US); the highest-priority language input.
• data-chat-size — small (default), medium, large, fullscreen, or embedded.
• data-chat-mode — normal (default) or split (a two-pane layout).
• data-env — development or production (otherwise inferred from the key prefix).
• data-theme — a JSON string of theme token overrides.

Advanced attributes

• data-origin — the Syncanix API origin (defaults to the production API).
• data-mount-target — a CSS selector for where to mount an embedded widget.
• data-config-load — lazy (fetch settings on first open, default) or eager (at mount).
• data-executor — the name of a global function that runs browser/host actions.
• data-token-provider — the name of a global function returning the end user’s token.
• data-step-up-provider — the name of a global function that triggers step-up re-authentication.
• data-client-witness — opt in to passive, shape-only API-traffic observation (off by default).
• data-act-on-behalf-consent — require a one-time 'act on your behalf' consent (off by default).

Next steps