Skip to main content

​
Dashboard settings

Widget configuration is managed from the dashboard under Settings → Widget. Changes are fetched by the SDK on initialization — no code changes required.

​
Appearance

SettingTypeDescription
primaryColorstringMain brand color (hex). Used for buttons, links, bubble background.
position'bottom-right' | 'bottom-left'Corner where the bubble appears.
borderRadiusstringBorder radius for the widget panel.
fontFamilystringFont family for widget text.
headerGradient{ from, to }Gradient colors for the widget header.

​
Behavior

SettingTypeDescription
welcomeMessagestringGreeting text shown in the widget home view.
autoOpenbooleanAutomatically open the panel on first visit.
showOnMobilebooleanShow the widget on mobile devices.

​
Features

SettingTypeDescription
sessionReplaybooleanEnable session replay recording.
fileUploadbooleanAllow users to upload files in conversations.
aiAssistantbooleanEnable AI-powered responses.

​
SDK overrides

Some settings can be overridden via the SDK init config: 
Hacktionbase.init({
  sdkKey: 'sk_live_abc123',
  tenant: 'acme',
  position: 'bottom-left',  // Overrides dashboard setting
  offset: { x: 16, y: 16 }, // Custom offset
  hidden: true               // Start hidden
});
The position from the SDK config takes precedence if the dashboard hasn’t set one. The dashboard’s position setting takes priority when configured.

​
Live preview

The dashboard includes a live widget preview that updates as you change settings. It uses a separate postMessage protocol (hacktionbase:preview_config) to send configuration changes to the preview iframe in real time.