Survey builder
The survey Build tab is a visual page builder. Content is stored as study pages with question blocks (and optional sections for grouping and randomization).
Page structure
Section titled “Page structure”| Concept | Description |
|---|---|
| Page | One screen participants see before clicking Next |
| Section | Groups pages; supports hierarchy, randomization, and section-level logic |
| Question block | A single question or content block on a page |
| Page break | Forces the next content onto a new page |
Use the page sidebar to add, reorder, duplicate, merge, or split pages.
Adding questions
Section titled “Adding questions”-
Select a page in the sidebar or canvas.
-
Click Add question (or the content block picker).
-
Choose a type from categorized groups:
- Text & Media
- Response Types
- Tables & Matrices
- Special Entries
- Information Architecture
- Choice Modelling
See Study content for every type and when to use it.
Editing a question
Section titled “Editing a question”Click a block to open the question editor — title, options, validation, required flag, and type-specific settings (e.g. scale labels for NPS).
Changes auto-save as you work (question auto-save pipeline).
Pages and sections operations
Section titled “Pages and sections operations”From the page sidebar or canvas controls you can:
- Append or insert a page at a position
- Duplicate a page
- Merge or split pages
- Reorder pages and question blocks
- Move blocks between pages
- Assign pages to sections for randomization
Page-level settings
Section titled “Page-level settings”Pages can have:
- Logic — when to show or skip the page
- Qualification logic — screener rules (include with legal/screener flows)
- Prototype assignment — not used in surveys (usability tests only)
Paste or import questions
Section titled “Paste or import questions”To add many questions at once or use AI type detection, see Paste content with AI.
Section randomization
Section titled “Section randomization”In Path Logic → Randomiser on a section (or page), choose how content is exposed:
| Mode | Behavior |
|---|---|
| No randomisation | Fixed order |
| Randomise order | Random order each session |
| Present a subset | Show K items from a pool (e.g. 1 of 3 pages) |
Optional Randomisation groups in subset mode map named groups (A/B/C) to pages or blocks for experiment analysis — same pattern as Compare assets.
For URL, device, or answer-based routing, use Display Logic instead.
See the full guide: Group comparison and routing.
Preview while building
Section titled “Preview while building”- Preview tab — embedded panel with desktop/mobile toggle
- Full preview —
/surveys/{id}/previewor list action Preview
Preview responses may be stored separately depending on study settings.
- Use Context text blocks for instructions between question groups.
- Use Page break to control pacing on long surveys.
- Keep screener questions on early pages with qualification logic so unqualified participants exit early.