Feedjoltdocs
Public portal

Embeddable widget

Add a Feedjolt feedback button to your site with one script tag. Customers search posts, vote, and submit without leaving your app. Configure look, SSO, and CSP.

The widget is a single <script> tag that adds a feedback button to your own site. Customers click, search existing posts, vote, or submit new ones - without leaving your app.

Installation

  1. Dashboard -> Settings -> Widget. Configure the look (color, position, launcher text).
  2. Copy the install snippet.
  3. Paste it before </body> on your site.
<script async src="https://www.feedjolt.com/widget-loader.js"
        data-workspace="acme"></script>

That's it. Refresh your site; you should see a floating button in the configured position.

Configuration

At Dashboard -> Settings -> Widget, you can set:

  • Launcher text - "Feedback", "Got an idea?", "Help us improve".
  • Position - bottom-right or bottom-left.
  • Theme - light, dark, auto (matches the user's OS preference).
  • Primary color - defaults to your brand color.
  • Active toggle - kill switch; turn the widget off without changing your install snippet.

For per-page overrides (theme, default board), see the developer reference at Developers -> Widget.

Single sign-on (SSO)

If your customers are already signed in to your app, you can pass their identity to the widget via the data-sso-token attribute on the script tag. The token format is being finalised - see Developers -> Widget -> Configuration for the current state.

Privacy

The widget sets a single first-party cookie (fj_widget) for state (open/closed) and a same-domain session cookie when the user submits feedback. No third-party trackers.

CSP

If your site has a strict CSP, allow:

  • script-src https://www.feedjolt.com
  • connect-src https://www.feedjolt.com
  • frame-src https://www.feedjolt.com
  • img-src https://cdn.feedjolt.com data: blob:

Removing

Delete the <script> tag. The widget disappears immediately.

On this page