Skip to content
Browse docs
Docs / Choose what to build

Surveys

Ask where the experience happens. Pick a format, paste one snippet.

01Pick a format

FormatBest for
BubblePersistent button that opens a feedback overlay. Most responses.
EmbedSits in your page layout, good for docs and help pages.
BannerThin bar that slides in after a delay.
ThumbsThumbs up or down, per feature.
TriggerZero footprint. Attach to any link or button.

All five are on every plan. To set the appearance and copy your survey API key, go to Settings, then Surveys. The data-survey value for each format is float, inline, bar, thumbs or page, in table order.

Your call: which moment you want to ask in.

02Bubble

The bubble is a floating button in the bottom corner of every page, and most responses come through it. Paste the script before </body>.

<script async src="https://app.annsa.ai/survey.js"
  data-api-key="YOUR_API_KEY"
  data-survey="float">
</script>

Use data-position (bottom-right or bottom-left) to move it.

03Embed

A "was this helpful?" widget in the page flow.

<div data-circuit-inline
  data-api-key="YOUR_API_KEY"
  data-context="help-article:api-docs"
  data-prompt="Was this helpful?">
</div>
<script async src="https://app.annsa.ai/survey.js"
  data-api-key="YOUR_API_KEY"
  data-survey="inline">
</script>

data-context tags every response, so you can read feedback per page.

05Tie responses to a person

Call window.AnnsaSurvey.identify({ email, name, plan }) once the script loads. Annsa then ties each response to that person and can draft them a note when the work ships.

06Test and read the answers

The install sheet, under Settings then Surveys, shows your embed code with your key filled in. Test loads your real survey. Responses join the same pool as every other source, and each survey has its own dashboard in Survey analytics.

Next guideSurvey analytics