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

# Settings Tab

> The Setup → Settings tab of a survey: the name and description, the source provenance of imported surveys, and the compiled identity — the Call Script and flows the survey compiles into, with a link to the script.

## What is on the Settings tab?

**Settings** is the last tab in **Setup** mode of the [survey workspace](/surveys/survey-workspace). The panel explains: *"The survey's identity and where it came from. The shell's own content — the agent, the FAQs, the behaviours, the gatekeeper and the closings — is authored on the Questions tab."*

So this tab is about the survey as a whole. The interviewer's voice, persona and call settings are in the [Agent](/surveys/agent) fixed section on the Questions tab, not here.

***

## General

*"Name and description apply across every version of the survey."*

| Field           | What it is                                                                                                                                                                    |
| --------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Name**        | The survey's name, shown on the surveys list, in the workspace header and on Results. The compiled Call Script carries the same name, so you can find it in **Call Scripts**. |
| **Description** | What the survey measures and when it should run. Shown under the name on the surveys list and matched by the list's search.                                                   |

Click **Save settings**. The confirmation is *Survey settings saved*. Saving needs the `surveys.edit` permission.

The name is also the study name spoken on inbound calls if you leave **Study name** in the Agent section and the first section's title empty.

***

## Source provenance

For a survey imported from a file, this card records exactly what was uploaded, one block per source:

| Field                   | Shows                                                                                                                        |
| ----------------------- | ---------------------------------------------------------------------------------------------------------------------------- |
| **Acquisition**         | How the file arrived.                                                                                                        |
| **Provider**            | The platform the file came from.                                                                                             |
| **Parser format**       | The format it was read as.                                                                                                   |
| **File**                | The file name.                                                                                                               |
| **Content type**        | The file type.                                                                                                               |
| **SHA-256 fingerprint** | A fingerprint of the file's exact contents. Uploading the identical file again is recognised and reuses the existing import. |

For a survey created in Voxworks, the card reads *"Native Voxworks survey — no external source snapshot."*

The **Source details** link on an imported survey's header opens this card. See [Importing surveys](/surveys/import).

***

## Compiled identity

*"Allocated on the first compile and reused by every version after it."*

| Row           | Shows                                                                                                                                                                                                                                                                                  |
| ------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Script**    | A link to the survey's compiled Call Script. Before the first compile: *"Not compiled yet — the id is minted on the first compile."*                                                                                                                                                   |
| **Flows (n)** | The flows the compile created, listed by key — `main` for the survey itself, then two for the gatekeeper and for each question that takes an answer (the question, and `(key).collect`). Before the first compile: *"None recorded — the compile job writes one id per emitted flow."* |

The script and flows are created once, on the first compile, and every later compile and publish updates the same ones. That means the script you add to a batch or assign to a number keeps working as you publish new versions — it always runs the latest published version.

Click the script id under **Script** to open it in **Call Scripts**, where you can place a test call or see its versions. See [Running a survey](/surveys/running-a-survey).

<Warning>Make changes to the survey, not to the compiled script. The next compile rewrites the script and its flows from the survey, so edits made in the script editor are overwritten.</Warning>

***

## What is not on this tab

* **Voice** — chosen in the [Agent](/surveys/agent#choose-a-voice) section.
* **Channel and language** — shown read-only on the [Readiness](/surveys/readiness) tab. Surveys created in the app are voice, in English.
* **Direction** — every survey runs both outbound and inbound; the [Gatekeeper](/surveys/gatekeeper) has a pane for each.