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 email/password or a social provider (Google, GitHub, Facebook). If you registered with email, check your inbox for a verification link — you can't sign in until you confirm it.

Already have a teammate's invite link instead? Use that link directly and skip straight to step 2 — your account and company are created for you as part of accepting the invitation.

2. Create your first domain

A domain is the website you want to collect feedback on. Head to Domains and add one — you'll give it a host (e.g. example.com) and pick which languages it should support.

Only an Admin can add a domain to a company — if you don't see a way to create one, ask whoever set up your account to either add it or invite you as an Admin. See Domains & companies for the full picture, including per-plan domain limits.

The Domains page listing two domains with their host and supported locales — 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, or on-site — then add steps and fields in the survey editor.

The Surveys list showing two published surveys with their type and last-change date — 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, one field per form must be flagged as the main evaluation question, and all translated text must be filled in for every locale the domain supports. The editor flags exactly what's missing as you go; once it's clean, publish from the survey's Actions menu.

Saving a survey (even with errors) keeps your draft — only publishing enforces the full validation checklist, so you can safely leave a survey half-built and come back to it later.

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 package — install @web-site-utilities/feedback 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.

The Setup guide in the app tracks these same five steps as a live checklist against your actual account — use it alongside this page to see exactly what's left. You need to be signed in (online, with a real session) to see it; it's not something this manual can show you a static snapshot of.