Installing the widget

The widget is a floating button that appears in the corner of your website. When a user clicks it, a panel opens to submit suggestions and open support tickets.

Installation

Paste the following snippet before the closing </body> tag on your website:

<script
  src="https://pliic.com/widget/v1.js"
  data-app-key="YOUR_APP_KEY"
  async
  defer
></script>

Replace YOUR_APP_KEY with the public key (pk_live_...) found on the app details page.

The async defer attributes ensure the script loads without blocking your page render.

Available attributes

The snippet accepts the following data-* attributes:

Attribute	Required	Description
data-app-key	Yes	Public app key (pk_live_...).
data-user-token	No	JWT to identify the logged-in user. See Authentication.
data-language	No	Force the widget language (e.g. en, pt-BR).
data-position	No	On-screen position: bottom-right, bottom-left, top-right, top-left.
data-modules	No	Enabled modules, comma-separated (e.g. suggestions,support).

Optional attributes override the settings defined in the dashboard. See Customization for details.

Verifying the installation

After adding the snippet:

1. Open your website in the browser
2. You’ll see the widget button in the corner of the screen
3. Click it and submit a test suggestion
4. Check the Pliic dashboard to see if the suggestion appeared

Compatibility

The widget works on any site that accepts HTML — WordPress, Shopify, React, Vue, static sites, etc.

Next steps

• Widget customization — appearance, modules and behavior
• Events API — control the widget via JavaScript
• Authentication — identify logged-in users
• Surveys — short polls for identified users
• Troubleshooting — when the widget doesn’t appear