Install · Webflow

Bug reports and feedback from your Webflow site, in one script tag.

Add a Webflow feedback widget and bug report button in Site Settings. One script tag in the footer code panel, then publish — no plugin, no app.
Start freeNo credit card required.

Where it goes

Site Settings → Custom Code → Footer Code, which Webflow injects before the closing body tag on every published page.

Setup

Adding the widget to Webflow

  1. 01

    Copy your widget key

    From the Widget tab of your project in UserWants. The key begins with uw_pk_ and is public by design: Webflow will publish it in your page source, and the domain allowlist rather than secrecy is what keeps it tied to your site.

  2. 02

    Paste it into Footer Code

    Open Site Settings, go to Custom Code and paste the tag into the Footer Code box. Footer rather than header, so the file loads after your page has rendered. This applies to every page on the site at once — you do not add it per page.

    html
    <script
  src="https://userwants.app/widget.js"
  data-userwants-key="uw_pk_..."
  defer
></script>
  3. 03

    Publish the site

    Custom code does not run in the Designer or in a share link preview — only on a published site. Click Publish and open the live URL. This trips up almost everyone the first time: the widget is not broken, the code simply has not shipped yet.

  4. 04

    Allow your domain

    Add your published hostname under Allowed domains in the Widget tab. If you are still on a webflow.io staging domain, add that too, because it is a different host from your custom domain and the allowlist fails closed.

Worth knowing

What bites on Webflow

The things that are specific to a visual site builder, rather than true of every install.

  • Custom code needs a paid site plan

    Webflow only injects Site Settings custom code on sites with a paid plan. On a free starter site the Footer Code box exists but nothing is published, so the widget will never appear no matter how many times you publish.

  • Page-level code overrides nothing, it adds

    If you paste the tag into both Site Settings and a page’s own custom code, the browser fetches the file twice. The widget refuses to initialise a second time, so you get one button — but remove the duplicate anyway.

  • Your Webflow styles cannot reach it

    Everything the widget renders lives in a closed shadow root, so nothing in your Webflow classes, interactions or global styles affects it, and it affects none of yours.

FAQ

Questions

Why is the widget not showing on my Webflow site?
Nine times out of ten the site has not been published since you pasted the code, or it is on a free plan where custom code is never injected. The third cause is a missing domain in the allowlist, which fails closed.
Does it work on Webflow Ecommerce and CMS pages?
Yes. Footer Code is injected into every published page including CMS collection templates and checkout, so the widget appears everywhere without adding anything per template or per collection item.

The full reference — every field the widget collects, the domain allowlist rules and the JavaScript API — is in the widget docs.

Try it on your Webflow site.

Paste the tag, add your domain, and the next report arrives with the screenshot and the JavaScript error already attached.

Start freeRead the docs