All docs

Trends and question concepts

Follow NPS, satisfaction and choice questions over time and across survey versions without mixing different scales.

Updated . 3 min read.

A survey changes over time. You reword a question, add an option, change a 1 to 5 scale to 1 to 7. Trends keeps the history honest: it follows the same question across versions and never adds up answers that were measured differently.

Open Surveys, your survey, Trends.

Question concepts

A concept is the stable meaning of a question, such as "likelihood to recommend". Formspring maps a question to a concept automatically each time a version of the survey is saved, using the question name, so the same question stays on the same concept across versions.

You can map a question yourself with Map question:

  • Join an existing concept of your workspace, for example to follow "How satisfied are you?" in two different surveys as one measure.
  • Start a new concept with your own label.

A question can only join a concept that measures the same kind of scale. An NPS question cannot join a 1 to 5 satisfaction concept, and another workspace's concepts are never reachable.

Read a trend

Pick a concept, a period (week, month or quarter) and optional filters. For each period you see the number of respondents, the response window, and the result: NPS with its promoter, passive and detractor split, the average and distribution for a rating, or the share per option for a choice question.

  • Periods with fewer than 30 respondents are marked as small samples.
  • When the scale or the options changed between versions, each scale is its own segment with a notice. They are never pooled into one line.
  • Responses collected before versions were recorded are shown as an unverified segment, not pooled with the rest.
  • An answer outside the recorded scale is left out of the counts and counted in a note.
  • The chart, the table and the CSV use the same denominator, with the same cohort filter applied.

Add a second cohort to compare, for example customers on Pro against customers on Free. It shows its own sample size.

Version on every response

Each new response records the survey version it was collected on. Responses that arrived before this was recorded are shown as an unverified segment until they are matched to a version by their time of arrival; contact support if you need that for an older survey.

Export

Export CSV writes the numbers of the page, including sample size and response window per period.

API and agents

With surveys:read and surveys:write:

  • GET /surveys/{survey}/trends/concepts lists concepts, POST maps a question.
  • GET /surveys/{survey}/trends?concept_id=...&granularity=month returns a trend, .../trends/export the CSV.
  • Agent tools: list_survey_concepts, get_survey_trend, map_survey_question_concept.

Cross-survey charts of a concept live on dashboards.

Next