How to add a feedback widget to a HubSpot site

Paste one line into your HubSpot site and publish. Your client clicks Feedback on the page, pins a comment where the problem is, and it lands in your dashboard with a snapshot of what they saw. About five minutes.

Before you start

  • A free Scopepin account. It takes a minute and needs no card.
  • Access to the HubSpot site's settings, as an owner, admin or someone allowed to add custom code.
  • The addresses the site runs on: the hs-sites.com address and the live domain, if it has one.

1Create a project for the client's site

In Scopepin, add a project and list every address the site runs on: the hs-sites.com address and the live domain.

The script only accepts feedback from the addresses you list, so a copy of the line pasted on another site does nothing. List client.com and it covers www.client.com too. The project page then shows your install line, with the project's own key in place of sp_….

2Paste the line into HubSpot

In HubSpot, open Settings, then Content, then Pages, choose the domain, paste the line into Site Footer HTML, and save.

If the domain uses the default settings, choose to override them for that domain first. For one page only, use the page's own Footer HTML under Settings, Advanced, in the page editor.

<script src="https://scopepin.com/w/v1.js" data-key="sp_…" async></script>

3Publish, then test it yourself

Publish the site, open it, click Feedback and pin a comment. It appears in your dashboard with a snapshot of the page.

Open the published page in a private window to test; the editor preview doesn't run footer code. The first time you send, the widget asks for your name and email, the way it will ask your client. Nobody needs an account.

4Send the link to your client

Send the client the page address and tell them to click Feedback in the corner. That's all they need.

Every comment is pinned to the element they clicked and arrives with their browser and screen size, so "the button looks wrong" comes with the page as they saw it.

What your client sees

A small Feedback button in the corner of your HubSpot site. They click it, then click the thing they want to talk about, and a card opens next to it. The first time, they type their name and email. They write the comment and can draw a box, an arrow, a note or a highlight on the page, or blur anything private. On a computer they can also record their screen with a voice-over for up to a minute. They never see a login, a price or a scope flag.

If you share the project's progress link, they can also follow every request they've sent, from received to in progress to done, without asking you.

If the button doesn't show

It shows on some pages but not others
Footer HTML can be set for the whole site or per page. Add the line in the site-wide settings so every page gets it.
The Feedback button doesn't appear
Check the site has been published since you added the line, then open it in a private window so you're not seeing a cached copy. The project's Settings shows whether the widget has been seen and on which address.
The project says the address isn't listed
The widget loaded on an address the project doesn't accept, often www or a staging domain. Use the one-click Add on the project, or list the address under its websites.
Feedback isn't arriving in the dashboard
Make sure the line on the site has the same key as the project you're looking at. Each project has its own key, so a line copied from another project sends feedback there.

What happens next

Each comment is checked against the scope you agreed with the client. The ones that go beyond it are flagged privately, and you can bundle them into a priced change request your client approves from a link.

Questions

Do my clients need a login?

No. They click Feedback on the site, pin a comment and type their name and email the first time. That's it.

Will it slow the site down?

The line loads after the page, and the part that captures the page snapshot only loads when someone sends feedback.

Does it work on blog posts and landing pages?

Site Footer HTML applies to the pages on that domain. Check one blog post after saving; HubSpot has separate settings for some content types.

How do I remove it after launch?

Delete the line where you added it and publish. The feedback you collected stays in your dashboard.

Setting up on another platform?

Put it on your next HubSpot build.

Free for one project, with unlimited clients and reviewers.

Free for one project. No card needed.