Building surveys

How do I ask for consent and add study terms?

Add a Consent block, host a terms page for your study or link your own, and see who agreed to which version.

Research studies usually need participants to agree before they answer. Surbee does this with a Consent block and an optional terms page.

  1. In the editor, type /consent or pick Consent from the components panel.
  2. Put it on its own page at the start of the survey.
  3. Edit the heading, the consent statement, the points the participant confirms, and the two answer labels.

The participant must choose agree or decline before they can go on. If they decline, the survey ends straight away and nothing else is asked. Those responses show as Declined on the Insights page, so you can count them without mixing them into your results.

Every consent is saved with the time it was given. In the response table and in exports it reads, for example, "Agreed on 2026-11-17, terms version 2 at ...".

Write a terms page

Open Settings, then Terms. Choose one of two options:

  • Hosted by Surbee. Write your terms, or select Draft terms to have Surbee write a first draft from your questions and settings. The draft describes what is recorded and how data is stored, and leaves anything it does not know, such as your name or ethics approval number, in [brackets] for you to fill in. Drafting costs 5 credits. Select Save and publish when it is ready. The page lives at your survey address followed by /terms, and participants can open it once the survey is published.
  • Link to my own page. Paste the address of your university's or organisation's terms page. It must start with https://.

Each time you change published terms, the version number goes up. A consent always records the version that was live when it was given.

Select the Consent block, then under Terms in the block settings choose Study page to use the terms from Settings, or Own link to paste a different address. You can change the link text too. The link only appears in the live survey once the terms are published.

Prepare a full ethics pack

In the home chat, ask Surbee to "prepare the ethics pack for" your survey. The Ethics agent writes a participant information sheet, a consent form, a data management plan and the survey section of an ethics application, all from the survey's real questions and settings. If you have uploaded your institution's ethics template, it follows that template instead. It can also save the information sheet as your draft terms page for you to review.

Treat everything it writes as a draft. Check it, fill in the bracketed parts, and have it approved by your ethics committee before you start.

Was this article helpful?