Install · Bubble

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

Add a Bubble feedback widget and bug report button through Settings → SEO & metatags. One script tag in the page body, no plugin to install.
Start freeNo credit card required.

Where it goes

Settings → SEO & metatags → Script/meta tags in body, which Bubble renders on every page of the app.

Setup

Adding the widget to Bubble

  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: Bubble renders it into your app’s HTML, and the domain allowlist rather than secrecy is what ties it to your app.

  2. 02

    Paste it into the body script box

    In the Bubble editor open Settings, then the SEO & metatags tab, and find the box for script and meta tags in the body. Paste the tag there rather than in the header box, so it loads after your page renders.

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

    Deploy to live and allow your domain

    Bubble keeps development and live versions on different URLs. Test on the version-test URL first, then deploy. Add both hostnames under Allowed domains in the Widget tab, because the allowlist fails closed and they are different hosts.

  4. 04

    Identify logged-in users

    Bubble apps almost always have accounts, which makes identify worth wiring. Add a JavaScript action from the Toolbox plugin on page load, using the current user’s unique id, and reports arrive attached to a real user record.

    js
    // Run javascript action, page load, "user is logged in"
window.UserWants?.identify({
  identifier: 'CURRENT_USER_UNIQUE_ID',
  email: 'CURRENT_USER_EMAIL'
});

Worth knowing

What bites on Bubble

The things that are specific to a no-code app builder, rather than true of every install.

  • Single-page app, single load

    Bubble navigates between pages without reloading the document in many setups. The widget attaches once and stays for the session, and each navigation is captured as a step in the report.

  • The editor is not the app

    Script tags do not run inside the Bubble editor. Preview the app in a browser tab to see the widget; nothing you do in the editor canvas will show it.

  • Toolbox is only needed for identify

    The install itself is pure copy-and-paste with no plugin. You only need the Toolbox plugin if you want to run the JavaScript that passes the logged-in user.

FAQ

Questions

Do I need a Bubble plugin to install the widget?
No. The tag goes in the SEO and metatags settings, which every Bubble plan includes. A plugin such as Toolbox is only required if you also want to pass the logged-in user id, which is optional.
Can my Bubble app users report bugs without logging in?
Yes. The widget never requires an account of its own, so a visitor stuck on your signup page can still report what went wrong — which is exactly the report you would otherwise never receive.

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 Bubble 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