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

# Question types

> All question types available in Caplena surveys, their settings, and how answers are stored in your project.

> [!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. Question types and settings may still change.

Add a question with **Add question**, or hover between two questions and click **+**. The type menu groups types into **Score**, **Choice**, **Open**, **Group** and **Other**, and you can search it.

![The question type menu](https://mintcdn.com/caplena-32172960/8VLjyD540Rp1inTq/images/surveys/question-type-menu.png?fit=max\&auto=format\&n=8VLjyD540Rp1inTq\&q=85\&s=0c6c1861a49f91f75b7cd02cb47aaf09)

Every answer is stored in its own project column. The column type decides how you can analyze it later: open text goes into topic analysis, while scores and choices can be used for filters, segments and [driver analysis](https://docs.caplena.com/insight-and-reports/insight-elements/driver-analysis.md). See [Where responses go](https://docs.caplena.com/surveys/monitor-and-analyze.md#where-responses-go) for which column type each question creates.

## Scores and scales

| Type | Use it for | Settings |
| - | - | - |
| **NPS** | "How likely are you to recommend us?" | Always **0–10**. Labels for the lowest and highest value (default "Not at all likely" / "Extremely likely"). |
| **CSAT** | Customer satisfaction | Always **1–5**. Labels for the lowest and highest value (default "Very unsatisfied" / "Very satisfied"). |
| **CES** | Customer effort | Always **1–7**. Labels for the lowest and highest value (default "Very difficult" / "Very easy"). |
| **Star rating** | Quick overall ratings | Number of stars, 2–10 (default 5). |
| **Likert** | Agreement, frequency, quality, likelihood or importance | **5** or **7** points, or your own number between 2 and 10, each with a label. Pick a ready-made set of labels: Agreement ("Strongly disagree" … "Strongly agree"), Frequency, Quality, Likelihood or Importance. |
| **Scale** | Any range of numbers, for example 0–100 | Lowest and highest value, and the step between values. Optional labels for the lowest and highest value. |
| **Generic score** | Your own score, grouped into ranges | A scale from 0 up to any value (at most 100). Define up to 3 groups of values, like NPS does with detractors (0–6), passives (7–8) and promoters (9–10). For scales up to 10 you can label each value. |
| **Numeric** | A number, such as an amount or age | **Whole number** or **Decimal**. Optionally a lowest and highest allowed value. |

Respondents answer scales of up to 12 points by tapping a number. Larger ranges show a slider.

## Choice

| Type | Use it for | Settings |
| - | - | - |
| **Single select** | Pick exactly one option | At least 2 options. Order: **Fixed order**, **Randomize order**, or **Randomize order except last** (useful for "None of these"). Optional **Other** option. |
| **Multi select** | Pick one or more options | Same as single select, plus how many options respondents may pick: any number, an exact number (for example exactly 3), or a range (for example 1 to 3). Respondents confirm with **Apply**. |
| **Yes / no** | Questions with two possible answers | Your own labels for the two answers, for example "Agree" / "Disagree". |
| **Country** | Country of residence, market | None. Respondents search a list of countries. |

With **Other** turned on, respondents who choose it are asked to specify their answer in a short follow-up text. That text is stored in its own text-to-analyze column.

![Settings of a multi-select question](https://mintcdn.com/caplena-32172960/8VLjyD540Rp1inTq/images/surveys/multi-select-settings.png?fit=max\&auto=format\&n=8VLjyD540Rp1inTq\&q=85\&s=1e57c265e4f241fad03ceecc2fdafe18)

## Open text

| Type | Use it for | Settings |
| - | - | - |
| **Open text** | Free-text feedback for analysis | Maximum answer length: 250, 600, 2,000 (default) or 5,000 characters, or your own minimum and maximum. A hint shown in the empty answer box. [AI follow-up questions (probing)](https://docs.caplena.com/surveys/logic-probing-and-parameters.md#ai-follow-up-questions-probing). |

Open-text answers land in a **text to analyze** column, so you can run [topic analysis](https://docs.caplena.com/topic-assignment/understanding-the-basics/starting-the-analysis.md) on them like on any other feedback. Respondents can type or speak their answer.

> [!TIP]
>
> Every survey should have at least one open-text question. Without one, the review warns that the survey produces no text to analyze.

## Other

| Type | Use it for | Settings |
| - | - | - |
| **Email** | Collecting an email address, for example for follow-up | Respondents must enter a valid email address. |
| **Date** | A calendar date | None. |
| **Message** | Intro text, instructions or a transition between sections. No answer is collected. | None. Can't be required. |

> [!NOTE]
>
> Questions and messages support basic formatting: **bold**, *italic*, lists and links.

## Matrix

A **matrix** asks several items on the same scale, for example "How much do you agree with the following statements?" followed by a list of statements. Respondents answer one row after the other in a single card.

![A matrix question in the builder](https://mintcdn.com/caplena-32172960/8VLjyD540Rp1inTq/images/surveys/matrix.png?fit=max\&auto=format\&n=8VLjyD540Rp1inTq\&q=85\&s=f8cba88d39c69c9a7fe793fc302c877b)

* A matrix has a shared question text and at least 2 **rows**.
* Rows can be fixed or shown in random order.
* Each row is stored in its **own column**, so you can analyze each item separately.
* Available row scales: Likert, NPS, CSAT, CES, Star rating, Generic score, Scale, Yes / no, Numeric and Single select.

Deleting rows until only one is left turns the matrix back into a regular question.

## Settings for all questions

| Setting | Description |
| - | - |
| **Required / Optional** | Optional questions show an **N/A** button so respondents can skip them. |
| **Column** | Store the answer in a new column (default) or an existing column. Use an existing column to compare answers with an earlier survey wave or an imported file. |
| **Show if** | Show the question only when a condition is met. See [Show if logic](https://docs.caplena.com/surveys/logic-probing-and-parameters.md#show-if-logic). |

> [!WARNING]
>
> Be careful when you change the column or the type of a question in a survey that's already live. Answers given before and after the change then end up in different columns, or in a different format, so they're hard to compare. The review warns you before you publish such a change.


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