Skip to main content

Docs / Install

Install the JavaScript feedback widget in minutes

No npm package required to start. Add one async script tag, verify your domain, and collect feedback with client debug on every plan.

Install Steps

  1. Create a FeedBlox account

    Register at FeedBlox.net and sign in to your dashboard. Free forever: 3 sites, 150 reports/month, no credit card.

  2. 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.

  3. 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 unlocks the production embed token for your domain.

  4. Copy the script snippet

    Open Widget settings for your site. Copy the script tag with your site ID, embed token, and preferred launcher position.

  5. Paste before </body>

    Add the snippet to every page where you want the launcher, typically just before the closing body tag. One tag is enough for standard SPAs that keep the shell loaded.

  6. 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

Replace placeholders with values from your dashboard. See MDN script element docs for async loading behavior.

<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="bottom-right"
  data-offset-bottom="16"
  data-offset-side="16"></script>

Optional: 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. Read the full FAQ for plans, privacy, and integrations.

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 npm or a build step?

No. FeedBlox is one async JavaScript snippet. Paste it before the closing body tag on pages where you want the launcher. SPAs 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.

Install today, read your first report this week

New accounts get Pro free for your first month: unlimited reports, screenshots, recordings, webhooks, and collaborators. No credit card. After the trial, Free forever: 3 sites, 150 reports/month, no credit card.

Start Free

No credit card required