Docs / Install Widget
Install the JavaScript Feedback Widget in Minutes
Add one async script tag, verify your domain, and collect feedback with client debug on every plan.
Install Steps
-
Create a FeedBlox account
Register at FeedBlox.net and sign in to your dashboard. Free forever: 3 sites, 150 reports/month, no credit card.
-
Add your site
Open Sites, click Add Site, and enter your public site URL (for example https://yoursite.com). FeedBlox scopes each widget to one site.
-
Verify domain ownership
Copy the verification meta tag from your dashboard into the <head> of your live site HTML (or layout template), deploy, then click Verify Site. Verification activates the production embed token for your domain.
-
Copy the script snippet
Open Widget settings for your site. Choose Floating Corner or Embedded on Page, then copy the snippet with your site ID and embed token.
-
Paste before </body>
For a floating launcher, paste the snippet before the closing body tag. For an embedded launcher, also place the empty div with your container id where the button should appear (nav, footer, or help page).
-
Publish and test
Load your site, open the launcher, and submit a test report. It should appear in your inbox within seconds with sentiment and client debug attached.
Example Script Tag
Copy the site ID and embed token from your dashboard into the attributes below. See MDN script element docs for async loading behavior.
Floating Corner (Default)
<link rel="preconnect" href="https://feedblox.net" crossorigin />
<script src="https://feedblox.net/widget.js" async
data-site-id="YOUR_SITE_ID"
data-token="YOUR_EMBED_TOKEN"
data-position="middle-right"
data-offset-bottom="16"
data-offset-side="16"></script>Static Launcher (Not Floating)
On the Widget page, set Feedback Trigger to Static and save a container element id, or pass data-container-id on the script. The panel still opens as
a popup from that button. If the id is missing, the widget falls back to the floating launcher.
<div id="feedback"></div>
<link rel="preconnect" href="https://feedblox.net" crossorigin />
<script src="https://feedblox.net/widget.js" async
data-site-id="YOUR_SITE_ID"
data-widget-id="YOUR_SITE_ID"
data-token="YOUR_EMBED_TOKEN"
data-container-id="feedback"></script>Optional for floating mode: data-offset-bottom and data-offset-side control launcher spacing. Widget Data and GDPR explains what the embed captures.
After Install
Reports land in your inbox with sentiment, element trail repro summary, and client debug (console, network, JS errors). Use web.dev performance guidance to keep your pages fast - the widget is designed to stay lightweight.
Explore bug reporting, user feedback, and developer feedback use cases.
Install FAQ
Common setup questions before you paste the snippet.
How long does it take to install the widget?
Most teams go live in under ten minutes: create an account, add a site, verify domain ownership, paste the script tag, and submit a test report.
Do I need a package manager or build step?
No. FeedBlox is one async JavaScript snippet. Paste it before the closing body tag on pages where you want the launcher. Single-page apps that keep the shell loaded need only one tag.
Where should I paste the script tag?
Just before </body> on each page, or once in your site template or tag manager. The script loads asynchronously and does not block first paint.
Why is domain verification required?
Verification proves you control the site before production embed tokens work. It keeps feedback scoped to your domain and reduces token misuse.
Can the launcher sit in my page instead of floating in a corner?
Yes. On the Widget page, set Feedback Trigger to Static, enter a container element id, and save. Place an empty div with that id where you want the button. You can also set data-container-id on the script. The feedback panel still opens as a popup from that button. If the id is missing, the widget falls back to the floating launcher.
New to FeedBlox? Read the Getting Started Guide.