> ## Documentation Index
> Fetch the complete documentation index at: https://docs.voxworks.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Sections

> How authored sections group a survey's questions: the section title and intro line, section keys, ordering, and how the first section's title stands in for the study name.

## What a section is

A **section** is a group of questions asked together — for example *Screening*, *Care experience* and *About you*. Sections give the questionnaire its shape in the outline and on the logic canvas, and can each open with a short spoken introduction.

Every new survey starts with one section, **Main survey**. A short survey can live entirely in it.

Sections are separate from the **fixed sections** (Agent, FAQs, Behaviours, Gatekeeper and Closing), which every survey has and which can't be moved or removed. See [Questions tab](/surveys/questions-tab).

***

## Adding a section

1. On **Setup → Questions**, click the **+** beside **Outline** (*"Add section"*).
2. The **New section** form opens. Enter a **Section title**.
3. Click **Add section** (toast *"Section added"*), or **Cancel**.

New sections are added after the existing ones. Use the move arrows to put it where it belongs.

## Editing a section

Click a section's heading in the outline to open its form. The form notes the section's key and question count: *"… The key is fixed: rules and the compiled agent name this section by it."*

| Field             | What it does                                                                                                                                                                                                          |
| ----------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Section title** | The section's name in the outline, on the logic canvas and in Results → Routes. Placeholder: *"e.g. Care experience"*. Required.                                                                                      |
| **Intro line**    | Spoken word for word, once, just before the section's first question. Placeholder: *"Read once before this section's first question"*. Leave it empty for no introduction. Available once the section has been added. |

Click **Save section** (toast *"Section saved"*) or **Close**.

### Writing a good intro line

* **Make it a statement, not a question.** The interviewer reads it and goes straight on to the first question, so *"Now a few questions about your last visit."* works; *"Is it OK if I ask about your last visit?"* invites an answer nothing is listening for.
* **Keep it short.** One sentence is usually enough.
* **Put notices here rather than in the greeting.** A recording or privacy notice sits well in the first section's intro line, so the greeting stays a single, clear consent question. For a notice the respondent must acknowledge, use a [Display](/surveys/question-types/display) question instead.

***

## Section keys

Each section has a key — `main` for the first section of a new survey. The compiled script refers to the section by its key. The key is set when the section is created and can't be changed, so renaming the section's title never breaks a rule.

***

## Order

* **Sections** are asked top to bottom as they appear in the outline. Reorder them with **Move section up** / **Move section down**.
* **Questions within a section** are asked in the order they appear. There's no question shuffling within a section — only answer options and battery items can be shuffled.
* To show a part of the survey to some respondents only, use routing rules on its questions: **Jump to question** past them, or **Hide question** on each one. See [Routing rules](/surveys/routing-rules).

***

## The first section and the study name

The **Study name** in the [Agent section](/surveys/agent) is what the interviewer calls the survey — for example in the line a respondent hears when they call back. If you leave **Study name** empty, the **first section's title** is used instead, and if that is empty too, the survey's name.

<Tip>Because of this fallback, a first section titled *Main survey* can end up spoken as the study name. Either fill in **Study name** in the Agent section, or give the first section a title that reads well aloud.</Tip>

***

## Next Steps

* [Questions tab](/surveys/questions-tab) — adding and moving questions within sections.
* [Routing rules](/surveys/routing-rules) — jumping ahead and hiding questions.
* [Agent section](/surveys/agent) — the study name and the rest of the interviewer's identity.