How to add a feedback widget to a Ghost site

Paste one line into your Ghost 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 Ghost site's settings, as an owner, admin or someone allowed to add custom code.
  • The addresses the site runs on: the ghost.io 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 ghost.io 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 Ghost

In Ghost admin, open Settings, then Code injection, paste the line into Site footer, and save.

Ghost adds Site footer code before the closing body tag on every page of the site.

<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 site in a private window to test. 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 Ghost 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

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.

Can I add it to one post only?

Yes. Each post and page has its own code injection in its settings; paste the line into its footer box instead.

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 Ghost build.

Free for one project, with unlimited clients and reviewers.

Free for one project. No card needed.