Skip to content
More from us
SpeedPy Django SaaS boilerplate Appliku Deploy on your own servers

Getting started

This walks the shortest path from a new account to an approved testimonial showing on your own site. It takes about ten minutes and needs no code until the last step.

1. Sign up

Create an account at withfeedback.com. Signing up creates a team and a first project for you automatically.

Confirm your email address before going further. Some things — invitations, notifications, password resets — only work once an address is verified.

Team, project, and where things live

A team is the billing and membership unit. A project is one product or site: it owns its own submissions, pages, widgets, surveys and contacts, and has its own public key. Most people need one team and one project. Add projects when you have genuinely separate products, not for separate pages within one.

2. Create a collection page

Collection → Pages → New page. This is a page we host for you, at a URL you can send people. You choose:

Field What it does
Slug The last part of the URL
Kind Testimonial or feedback — changes the wording
Headline / intro What the visitor reads first
Collect rating Show the 1–5 stars
Collect video Offer a recorder as well as a text box (needs a plan with video)

Open the page and submit something yourself. That is the fastest way to see the whole loop, and you can delete it afterwards.

3. Approve it

Inbox lists everything that arrived, newest first. Your test submission is sitting there as pending.

Approving is deliberate and it is the only way anything becomes public. You can also reject, mark as spam, restore, and add tags. Every one of those actions is recorded with who did it and when.

Approved is not the same as displayable

A submission shows in a widget only when it is approved and the person ticked the display-consent box. If you approve something submitted without consent, it stays out of your embeds on purpose — you can still read it, quote it in a case study, or ask the person for permission.

4. Create a widget

Widgets → New widget. Pick Wall to start. The preview on the widget page renders the real bundle with your real data, so what you see is what your visitors get.

5. Put it on your site

The widget page gives you a snippet. It looks like this:

<script async
  src="https://withfeedback.fra1.cdn.digitaloceanspaces.com/widget/v1/widget.js"
  data-wf-key="YOUR_PUBLIC_KEY"
  data-wf-widget="YOUR_WIDGET_ID"></script>

Paste it where you want the wall to appear. The script inserts the widget immediately after itself, inside a shadow root, so it cannot inherit or leak your page's CSS.

That is the whole loop. Everything below is refinement.

Where to go next

  • The widget

    Collect and display from one script tag, including a launcher panel that lives on your own site.

  • Video testimonials

    In-browser recording, on a hosted page or inside the widget.

  • Surveys and NPS

    Versioned surveys, so editing one mid-flight does not corrupt your aggregates.

  • The API

    Everything the dashboard does, over HTTPS.