Documentation

Everything you need to start collecting feedback with Feedforward — from your first survey to widget customization and the dashboard.

Quickstart

You can have a survey live on your site in under five minutes. There are three steps:

Create a survey in the dashboard and add your questions (NPS, CSAT, or free text).
Grab your embed key from Settings → Embedding and copy the survey ID shown on the survey's overview page.
Paste the script tag below into your site's HTML, just before the closing body tag.

<script
  src="https://widget.getfeedforward.com/v1.js"
  data-embed-key="ek_live_..."
  data-survey-id="srv_..."
  async
></script>

That single tag loads the widget asynchronously, isolates it in a closed Shadow DOM so it never clashes with your styles, and starts collecting responses immediately.

Concepts

Feedforward is built around four core objects:

Surveys — a container for questions, targeting rules, and appearance. Each survey has a stable ID you reference from the widget.
Questions — the individual prompts in a survey. Supported types include NPS (0–10), CSAT rating, and open-ended text.
Responses — submissions from your end users. Each response is timestamped and attributed to a survey.
AI insights — for text responses, an async worker extracts a theme, sentiment, and short summary so you do not have to read every comment by hand.

Widget customization

The widget is configured entirely through data-* attributes on the script tag. No JavaScript API is required for the common cases:

data-embed-key — your organization's public embed key. Required.
data-survey-id — the survey to display. Required.
data-locale — optional BCP-47 locale (for example en or fr) used to localize built-in widget copy.

For a deeper look at theming, positioning, and the widget's security model, see the widget guide.

Dashboard basics

The dashboard is where you build surveys and read results. Live responses stream in over SSE, so the analytics overview and response feed update in real time without a refresh. From here you can edit questions, watch AI insights land as they are processed, and export your data.

Building an integration on top of Feedforward? Head over to the API reference for authenticated programmatic access.