Widget customization

The widget is fully customizable from the dashboard. You can adjust colors, position, modules and behavior without touching your site’s code.

Dashboard configuration

Settings live on the app edit page, under the Widget tab. Changes are applied automatically — just save and reload the page where the widget is installed.

Visitor identity

Setting	Type	Default	Description
allow_visitor_otp	boolean	true (on)	Lets visitors without a login identify themselves by email and a verification code to suggest, vote, comment, and open tickets. When off, the widget only shows the read-only suggestion board for anyone without a data-user-token.

See the full flow in User authentication.

Theme

Setting	Type	Default	Description
primary_color	hex	#3B82F6	Main color for the button and highlights.
position	enum	bottom-right	On-screen position: bottom-right, bottom-left, top-right, top-left.
button_text	text	Feedback	Floating button label.
button_icon	enum	message-circle	Button icon: message-circle, megaphone, lightbulb, help-circle or none.
border_radius	pixels	8	Corner rounding of the widget.

Example: set primary_color to #16A34A and button_text to Suggestions for a green button with a custom label.

Suggestion form

The emotion and category fields for the new suggestion form aren’t on this tab — they live on the app’s General tab, in the “Suggestion form” section. See Creating an app.

Modules

Setting	Type	Default	Description
suggestions	boolean	true	Enables the suggestions tab.
support	boolean	false	Enables the support/tickets tab.
default_tab	enum	suggestions	Tab opened by default: suggestions or support.

If only one module is enabled, the widget opens straight into it, without showing the tabs.

Behavior

Setting	Type	Default	Description
auto_open	boolean	false	Opens the panel automatically on page load.
trigger_delay	milliseconds	0	Delay before the auto-open triggers.
close_on_outside_click	boolean	true	Closes the panel when clicking outside it.

Example: with auto_open enabled and trigger_delay set to 5000, the panel opens on its own 5 seconds after load.

Overriding via attributes

Some values can be overridden directly in the snippet, without changing the dashboard. This is useful when the same app is used in different contexts (for example, different languages per page).

<script
  src="https://pliic.com/widget/v1.js"
  data-app-key="YOUR_APP_KEY"
  data-language="en"
  data-position="bottom-left"
  data-modules="suggestions"
  async
  defer
></script>

Attribute	Overrides
data-language	Automatically detected language.
data-position	Panel position.
data-modules	Panel suggestions / support.

Attributes take priority over dashboard settings.