Quick start guide

Five steps to get from a new account to real feedback showing up on your dashboard.

1. Create your account

Sign up from the homepage with your email or your Google account. If you signed up with email, open the link in the confirmation email and choose your password there. Confirming it signs you in.

2. Add your website, or start without one

The first time you sign in, you're asked whether you have a website you want to collect feedback on.

  • If you have one, enter its address (e.g. example.com) and pick which languages your surveys on it should support. It becomes your first domain: the website you collect feedback on. Domains are managed on the Domains page.
  • If you don't, just pick the languages. Your space is set up without a website straight away, and you can create on-site and email surveys, which don't need one. When you get a website, add it on Domains; your surveys and responses stay as they are.
Domains you own, with their host and configured locales.

3. Create your first survey

Go to Surveys and click New survey. You'll choose a form type up front: inline, popup, popup with no button, on-site, email, or chat. Then add steps and fields in the survey editor. In a space without a website, pick an on-site or email survey: the other types are shown on your own website, so they can only be created once you add one.

Published surveys, with their type and an Embed button per row.

4. Publish your survey

A survey can't go live until it passes validation: every step needs at least one field, all translated text must be filled in for every locale the domain supports, and a popup survey also needs a main evaluation and a main feedback question. The editor flags exactly what's missing as you go; once it's clean, publish from the survey's Actions menu.

5. Add the embed script to your site

Back on the Surveys list, click the Embed icon on a published survey's row. You'll get two options:

  • Script tag: paste a <div> placeholder plus a <script> block directly into your page's HTML. No build step, works on any site.
  • npm: install the @web-site-utilities/feedback package and call initiateFeedbackModule() yourself, if your site already has a JS build pipeline.

Either way you pass the survey's formId and the id of the container element you want the widget to render into. Once the script is live on your site and someone submits the form, the response shows up on your dashboard and in Responses.

To open the survey from your site’s own code, after a purchase or from your own menu for example, see JavaScript API.

On-site and email surveys need no script: you share an on-site survey's link from its Access tab, and send an email survey from Campaigns.