Configuration

The widget pulls its configuration from the Trackelio API using your project key. All settings are managed from the dashboard under Sites > Widget, so changes take effect without redeploying your site.

Trigger button

The trigger button is the floating element users click to open the widget panel.

Setting	Options	Description
Position	bottom-right, bottom-left, top-right, top-left, middle-right, middle-left	Where the button appears on the viewport.
Shape	pill, circle, square-rounded	Visual shape of the button.
Label text	Any string	Text displayed on the button (e.g., “Feedback”).
Icon-only mode	On / Off	When enabled, the button shows only the icon without label text.
Offset X	Pixels	Horizontal distance from the edge of the viewport.
Offset Y	Pixels	Vertical distance from the edge of the viewport.
Z-index	Number	CSS z-index for the trigger button and panel.

Panel

The panel is the container that opens when a user clicks the trigger button.

• Width — Set a custom width in pixels. Defaults to 400px.
• Default module — Choose which module is shown when the panel first opens (e.g., Feedback, NPS, Messenger).
• Module selector tabs — Show or hide the tab bar at the top of the panel. When hidden, only the default module is accessible.

Guest submissions

Control whether anonymous visitors are prompted for identifying information when submitting feedback.

• Name field — Toggle the name input on or off.
• Email field — Toggle the email input on or off.

When both fields are disabled, guests can submit feedback without providing any contact details. When the user has been identified via the SDK identify() method, these fields are hidden automatically.

Capture mode

Enable or disable the “Point to element” feature, which allows users to select a specific element on the page before submitting feedback. When enabled, a crosshair overlay appears and the user can click any element to attach it to their submission. See Visual Feedback for details on how element selection works.

Runtime overrides

You can override any configuration value at runtime using the SDK:

window.Trackelio.setConfig({
  position: 'bottom-left',
  panel_width: 480,
  default_module: 'nps',
  show_module_tabs: false,
});

Runtime overrides persist for the current page session. They do not modify the configuration stored in your dashboard.