Install · Squarespace
Bug reports and feedback from your Squarespace site, in one script tag.
Where it goes
Settings → Developer Tools → Code Injection → Footer, which Squarespace inserts before the closing body tag site-wide.
Setup
Adding the widget to Squarespace
- 01
Check your plan
Code Injection requires a Business plan or one of the Commerce plans. On Personal the panel is not available, and there is no other supported way to add a script tag site-wide. Worth confirming before anything else.
- 02
Copy your widget key
From the Widget tab of your project in UserWants. The key begins with uw_pk_ and is public by design: it is served in your page source to every visitor, and the domain allowlist is what ties it to your site.
- 03
Paste it into the Footer injection box
Open Settings, then Developer Tools, then Code Injection, and paste the tag into Footer rather than Header. Footer means the widget loads after your content, so nothing about your page render waits on it.
html<script src="https://userwants.app/widget.js" data-userwants-key="uw_pk_..." defer ></script> - 04
Allow your domain
Add your live hostname under Allowed domains in the Widget tab. If your site is still on a squarespace.com preview URL, add that as well — it is a different host, and the allowlist fails closed rather than open.
Worth knowing
What bites on Squarespace
Injected code does not run in the editor
Squarespace strips custom code while you are editing the site and in some preview modes. Open your live site in a normal browser tab to check the widget, not the editing view.
Ajax loading can confuse you, not the widget
Some older templates load pages by Ajax without a full reload. The widget attaches once and stays, so it keeps working — but a hard refresh is still the right way to test a change to the injected code.
Cookie banners are yours, not ours
The widget sets no cookie and no cross-site identifier, so it does not need a consent category. If your banner blocks all third-party scripts by default, it will block this one too until you allow it.
FAQ
Questions
- Can I add the widget on a Squarespace Personal plan?
- No. Code Injection is a Business plan feature, and Squarespace offers no other supported way to load a site-wide script. Upgrading the plan is the only route, which is a Squarespace limitation rather than something the widget can work around.
- Will the widget slow my Squarespace site down?
- It is one deferred request of roughly 12 KB compressed, fetched from a CDN after your page is interactive. It never blocks rendering, and because it sits in Footer injection it loads behind everything Squarespace itself needs.
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 Squarespace site.
Paste the tag, add your domain, and the next report arrives with the screenshot and the JavaScript error already attached.