> ## 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.

# Questions tab

> The Setup → Questions tab: the Outline of fixed and authored sections, adding, moving and deleting sections and questions, the inspector pane, and the Routing card under each question.

## Layout

**Setup → Questions** is where the questionnaire is built. It has two panes:

* **Outline**, on the left — every section and question in the order a respondent meets them.
* **The inspector**, on the right — the form for whatever you've selected in the outline: a question, a section, or one of the fixed sections.

Until you select something, the right pane reads *"Select a question in the outline to see its details."*

***

## The Outline

The outline runs top to bottom in call order:

| Rows                                                                                               | What they are                                                                                                                          |
| -------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------- |
| **Agent**, **FAQs**, **Behaviours**, **Gatekeeper** (with **Outbound** and **Inbound** beneath it) | The **fixed sections** every survey has. Each carries a lock icon and a **Fixed** tag: you fill them in but can't move or delete them. |
| Your sections                                                                                      | The **authored sections**, each with its title and question count, and its questions beneath it.                                       |
| **Closing**                                                                                        | The last fixed section — outcome codes, closing texts and the farewell.                                                                |

Each question row shows the question key, its title (or its prompt, if it has no title), an asterisk `*` if the question is **Required**, and a coloured support dot when the question needs attention.

### The fixed sections

| Section                   | Description in the app                                                                              | Covered in                                            |
| ------------------------- | --------------------------------------------------------------------------------------------------- | ----------------------------------------------------- |
| **Agent**                 | *"Who is calling, how the study is conducted, and the floor every question inherits."*              | [Agent section](/surveys/agent)                       |
| **FAQs**                  | *"What the respondent may ask about the call, the study or the interviewer."*                       | [FAQs](/surveys/faqs)                                 |
| **Behaviours**            | *"Busy and stop — what counts as each, in the respondent's words."*                                 | [Behaviours](/surveys/behaviours)                     |
| **Gatekeeper → Outbound** | *"What the call says to whoever picks up — a live person, a screen, or a machine."*                 | [Gatekeeper](/surveys/gatekeeper)                     |
| **Gatekeeper → Inbound**  | *"What a respondent who calls back is told before they are asked to take part."*                    | [Gatekeeper](/surveys/gatekeeper)                     |
| **Closing**               | *"Every code the interview can end with, the closing spoken for it, and the farewell spoken last."* | [Closing and outcomes](/surveys/closing-and-outcomes) |

***

## Adding sections and questions

* **Add a section** — click the **+** beside **Outline** (*"Add section"*). The section form opens on the right; give it a **Section title** and click **Add section**. See [Sections](/surveys/sections).
* **Add a question** — click **+ Add question** under the section it belongs to. A new question opens in the inspector as a **Single choice** with two options, **Yes** and **No**. Change the **Type**, write the **Voice prompt**, and click **Add question** at the bottom of the pane. The toast *"Question added"* confirms it.

A question can't be saved without a voice prompt — the save button says *"Add a voice prompt to save."* until you've written one.

On a new survey, **Main survey** sits below the fixed sections with no questions until you add one. The prompts *"Add a section to start building this survey."* and *"Add a section, then add your first question to it."* appear when a version has no sections or questions yet.

***

## Moving sections and questions

* **Up and down arrows** — each section and question row has **Move section up / down** or **Move question up / down** arrows. Each press saves the new position straight away.
* **Drag and drop** — drag a question to a new place in its section, or into a different section.

Questions are asked in outline order: section by section, and top to bottom within each section. Routing rules can skip ahead; see [Routing rules](/surveys/routing-rules).

<Warning>A jump rule can only go forward. If you move a question above the question a jump rule sends respondents from, that rule stops being valid — check the **Logic** tab after reordering.</Warning>

***

## The question inspector

Selecting a question opens its settings on the right. The header row shows the section, a type badge and — only when the question needs attention — a support badge (**Transformed**, **Read Only** or **Unsupported**). **Required** sits on the right of the same row.

What the inspector shows depends on the question's type:

* [Question settings](/surveys/question-settings) covers what every type shares — title, key, voice prompt, alternative phrasings, the **Voice** panel and the **Behaviour** panel.
* Each type's own page covers the rest: [Display](/surveys/question-types/display), [Single choice](/surveys/question-types/single-choice), [Rating](/surveys/question-types/rating), [Battery](/surveys/question-types/battery), [Number](/surveys/question-types/number), [Long text](/surveys/question-types/long-text), [First name](/surveys/question-types/first-name), [Phone number](/surveys/question-types/phone-number).

At the bottom of the pane, **Save changes** saves the question (toast *"Question saved"*) and **Delete** removes it (toast *"Question deleted"*). The buttons stay pinned to the bottom as you scroll.

### The Routing card

Below each question sits a **Routing** card listing the rules that leave from this question and the rules that arrive at it, with **Edit in Logic** (or **Open Logic** on a read-only version) to jump to the Logic tab.

* With no rules: *"No rules reference this question. Respondents continue to the next step."*
* On a Display question: *"Display steps take no answer, so nothing branches from here."*
* A rule tagged **Not run** is one the voice interviewer doesn't carry out — usually one that came in with an import.

See [Logic tab and canvas](/surveys/logic).

***

## Deleting a question

A question that other parts of the survey depend on can't be deleted until those parts are changed. The refusal names what's in the way, for example:

* *"This question is used by the rule “skip\_q5” (trigger). Delete or edit that rule first."*
* *"The variable “first\_pref” is derived from this question. Delete or re-point it first."*

A question that already has recorded answers on this version can't be deleted either. Create a new draft from **Version history** and delete it there, or hide it with a rule. See [Versions and drafts](/surveys/versions).

### Renaming a question key

Rules refer to questions by key. If you change a key that rules use, the inspector warns *"1 rule references this key (…). Renaming updates them too."* — saving updates those rules for you. After a rename, also check any later prompt that pipes this question's answer (see [Survey variables and piping](/surveys/survey-variables)).

***

## Next Steps

* [Sections](/surveys/sections) — titles, intro lines and ordering.
* [Question settings](/surveys/question-settings) — the fields every question shares.
* [Logic tab and canvas](/surveys/logic) — adding routing between questions.
