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

# Edit your survey

> Use the survey builder to edit questions, survey settings, branding and the closing screen, and preview the survey as respondents will see it.

> [!NOTE]
>
> Surveys is in **closed beta** and not yet available to all customers. [Join the waitlist](https://caplena.com/en/ai-survey-tool) to get access. See [Surveys overview](https://docs.caplena.com/surveys/overview.md) for current limitations.

The survey builder is the first step of a survey. The steps bar at the top reads **Survey** › **Review** › **Monitor**. A green dot on **Monitor** means the survey is live.

![The survey builder](https://mintcdn.com/caplena-32172960/8VLjyD540Rp1inTq/images/surveys/builder-overview.png?fit=max\&auto=format\&n=8VLjyD540Rp1inTq\&q=85\&s=a69f33dedd07ab02b6bc20f011ed9615)

The builder has three areas:

| Area | What it's for |
| - | - |
| **Agent** (left) | Chat with the survey agent to draft or change the survey. See [Create a survey](https://docs.caplena.com/surveys/create-a-survey.md#4-refine-with-the-agent). |
| **Editor** (center) | Edit the goal, the settings, the questions and the closing screen. |
| **Preview** (right) | Try the survey as a respondent, on desktop or mobile. |

All changes **save automatically**. They go to the **draft**: respondents keep seeing the published version until you [publish again](https://docs.caplena.com/surveys/review-and-publish.md).

## The editor header

At the top of the editor you'll find:

* **Version status**: for example **Draft · not published**, **Draft · 3 changes from v2**, or **Live**. Click it to open the [version history](https://docs.caplena.com/surveys/review-and-publish.md#version-history). See [How versions work](https://docs.caplena.com/surveys/review-and-publish.md#how-versions-work).
* **Questions** / **Translations**: switch between editing questions and [managing translations](https://docs.caplena.com/surveys/languages-and-translations.md).
* **Issues**: problems the review found, with a **Fix** button that jumps to the affected question.

Below the header are the **survey goal**, the **survey name** and an **estimated duration** for respondents.

## Survey settings

The row of settings under the survey name applies to the whole survey. Click a setting to change it.

![Survey-level settings](https://mintcdn.com/caplena-32172960/8VLjyD540Rp1inTq/images/surveys/settings-chips.png?fit=max\&auto=format\&n=8VLjyD540Rp1inTq\&q=85\&s=e6d507c2fd11904cc1ffc07932b52094)

| Setting | What it does |
| - | - |
| **Language** | The base language you write the survey in. All other languages are translated from it. It can only be changed while the survey has no questions. |
| **Progress bar** | Shows a progress bar at the top of the survey. On by default. Respondents always see "Question X of \~Y" in the header, even when the bar is off. |
| **Voice conversation** | Turns on **voice mode**, so respondents can answer the whole survey by talking, and shows a start screen where they choose between voice and typing. On by default. Respondents can always dictate open-text answers with the microphone, even when this is off. See [Answering by voice](https://docs.caplena.com/surveys/respondent-experience.md#answering-by-voice). |
| **Branding** | Logo, primary color and background. See [Branding](#branding). |
| **Parameters** | Values passed in through the survey link, such as a customer segment or campaign. See [URL parameters](https://docs.caplena.com/surveys/logic-probing-and-parameters.md#url-parameters). |
| **Incomplete responses** | Whether responses that were started but not finished are added to your project, and after how long. See [Incomplete responses](#incomplete-responses). |

When **Voice conversation** is on, you can also set a **Start screen title** (up to 55 characters). It's shown on the welcome screen respondents see before the survey starts.

### Branding

Open **Branding** to make the survey look like your brand. By default, the survey uses your project's [custom theme](https://docs.caplena.com/insight-and-reports/creating-and-customizing-reports/custom-theme.md).

* **Logo**: upload an SVG or PNG. A transparent background works best.
* **Primary color**: used for buttons, the respondent's answer bubbles, selected options and the progress bar.
* **Background**: a solid **color**, or an **image** (JPG or PNG, at least 1920 × 1080 px). For images, set an **image overlay** to tint the image so text stays readable.

![Branding settings](https://mintcdn.com/caplena-32172960/8VLjyD540Rp1inTq/images/surveys/branding.png?fit=max\&auto=format\&n=8VLjyD540Rp1inTq\&q=85\&s=70bf117a86b7f90829d8927c0187ceb8)

Branding is part of the published version. If you change it on a live survey, publish again to apply it.

### Incomplete responses

Some respondents start a survey and don't finish it. With **Ingest incomplete responses** turned on (default), an unfinished response is marked as partial and added to your project once the respondent has been inactive for a while. You choose how long under **Inactive before ingest** (1 to 72 hours, default 24). When it's off, incomplete responses are discarded.

![Settings for incomplete responses](https://mintcdn.com/caplena-32172960/8VLjyD540Rp1inTq/images/surveys/incomplete-responses.png?fit=max\&auto=format\&n=8VLjyD540Rp1inTq\&q=85\&s=3e0bffe7de95527dc3671ad064aa3430)

## Questions

![An open-text question with its settings](https://mintcdn.com/caplena-32172960/8VLjyD540Rp1inTq/images/surveys/open-text-question.png?fit=max\&auto=format\&n=8VLjyD540Rp1inTq\&q=85\&s=76c9b7c604dd60f1f09f6643c06dfd4a)

* **Add a question**: click **Add question** at the end of the list, or hover between two questions to insert one there. Pick a type from the menu. See [Question types](https://docs.caplena.com/surveys/question-types.md).
* **Edit**: click into the question text to edit it. The question's settings are shown underneath; click one to change it.
* **Reorder**: drag a question by its handle.
* **Duplicate or delete**: use the actions on the question.
* **Preview from here**: opens the preview at this question, with the earlier questions already answered with sample answers.

Every question that collects an answer has these settings:

* **Required** / **Optional**: optional questions show an **N/A** button to respondents.
* **Column**: where the answer is stored in your project. By default each question creates a **new column**. Choose **Use existing column** to add the answers to a column you already have, for example to compare them with an earlier survey wave or an imported file.
* **Show if**: show the question only when a condition is met. See [Logic](https://docs.caplena.com/surveys/logic-probing-and-parameters.md#show-if-logic).

> [!TIP]
>
> You can insert earlier answers and URL parameters into question text, for example "You rated us **7**. What would make it a 10?". See [Dynamic text](https://docs.caplena.com/surveys/logic-probing-and-parameters.md#dynamic-text-in-questions).

## Closing screen

The **Closing** section at the end of the list holds the **closing message**: the last message respondents see after the final question (up to 500 characters). A closing message is required to publish.

## Preview

The **Preview** panel on the right runs the real respondent experience against your current draft. Switch between **desktop** and **mobile**, pick a **language**, and refresh to start over.

![Previewing the survey on mobile](https://mintcdn.com/caplena-32172960/8VLjyD540Rp1inTq/images/surveys/preview-mobile.png?fit=max\&auto=format\&n=8VLjyD540Rp1inTq\&q=85\&s=8b6ef86e27e102a958ed09b24b3c2bb5)

Preview and test answers are **never added to your project** and don't count in monitoring.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.