> For the complete documentation index, see [llms.txt](https://docs.askyazi.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.askyazi.com/build-a-study/question-types.md).

# Question types

Reference for every question type in Yazi, what the participant sees on WhatsApp, and the settings each type offers.

This page lists every question type in the Yazi builder, shows what a participant sees on WhatsApp for each one, and explains the settings you can apply. For the hard WhatsApp numbers (option counts, character lengths, row limits) see [WhatsApp limits](https://docs.askyazi.com/build-a-study/whatsapp-limits.md).

{% hint style="info" %}
**In short:** Yazi has 16 question types, including matrix (rating grid) questions, NPS and media uploads. Every type works in an in-chat survey. Voice notes, video and location cannot run inside a WhatsApp Flow, and Matrix is not available in Flow-based surveys. There is no ranking question type: use the piping workaround below.
{% endhint %}

## Adding and editing a question

On the **Build** tab, click the **+** between two questions to insert one, or click an existing question to open its editor.

* **Question text** supports **B** (bold), **I** (italics) and **Q** (quote) formatting, with a character counter (maximum 500 characters).
* **Add Emoji** inserts an emoji. **Improve** asks the AI to suggest a clearer wording, which you can accept or ignore. **Add Media** attaches an image, video, audio file or document to the question. See [Media in questions](https://docs.askyazi.com/build-a-study/media-in-questions.md).
* **The type dropdown** on the right of the editor sets the question type.
* **Row icons** on each question: logic (branch icon, with a badge counting its rules), routing, settings (gear), preview (eye), duplicate and delete.

Click the **eye** icon to preview exactly how the question will look on WhatsApp.

<figure><img src="https://358667285-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FzMRQUXiGQlBwWdg6WEmG%2Fuploads%2FWAG3TQWiLcFYuvtY6TVb%2Ffs-question-editor-single.webp?alt=media&amp;token=47141c5f-81dc-4f1a-a4a4-be86e5b2e49d" alt="Editing a single select question: question text, type, Add Emoji, Improve and Add Media, and the answer options"><figcaption></figcaption></figure>

## All question types

<figure><img src="https://358667285-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FzMRQUXiGQlBwWdg6WEmG%2Fuploads%2FElonlZPeh6lLbi4vhGZe%2Ffs-add-question-types.webp?alt=media&amp;token=41d93dbf-b3a0-449d-a57d-668e954819a0" alt="Adding a question: the + button opens the list of question types and Add block"><figcaption></figcaption></figure>

| Type              | What the participant does               | What they see on WhatsApp                                                                           | Flow support |
| ----------------- | --------------------------------------- | --------------------------------------------------------------------------------------------------- | ------------ |
| **Text**          | Types a free-text answer                | A normal message; they reply in the chat                                                            | Yes          |
| **Date**          | Enters a date                           | A prompt; invalid dates are rejected and re-asked                                                   | Yes          |
| **Email**         | Enters an email address                 | A prompt with email validation                                                                      | Yes          |
| **Phone**         | Enters a phone number                   | A prompt with phone number validation                                                               | Yes          |
| **Number**        | Enters a number                         | A prompt; you can set a minimum and maximum, and out-of-range replies are re-asked naming the range | Yes          |
| **Rating Scale**  | Picks one point on a scale              | A tappable form with the scale points and anchor labels                                             | Yes          |
| **NPS**           | Picks 0 to 10                           | A tappable grid of 0 to 10 with anchor labels ("0 = Not at all likely, 10 = Extremely likely")      | Yes          |
| **Single Select** | Picks one option                        | Buttons, a list or a lettered list, depending on how many options and how long they are             | Yes          |
| **Multi Select**  | Picks several options                   | A form with tick boxes, or a lettered list for very long lists                                      | Yes          |
| **Matrix**        | Rates several items on one shared scale | A form with each item and a row of tappable chips (or a dropdown per item)                          | No           |
| **Picture**       | Sends one or more photos                | A message asking for a photo; they send from camera or gallery                                      | Yes          |
| **Voice Note**    | Records a voice note                    | A message asking for a voice note                                                                   | No           |
| **Video**         | Sends a video                           | A message asking for a video                                                                        | No           |
| **Document**      | Sends a file                            | A message asking for a document; you can require Word, PDF or both                                  | Yes          |
| **Location**      | Shares a location pin                   | A message asking them to share their location                                                       | No           |
| **Statement**     | Reads a message and taps **Continue**   | Your text with a **Continue** button; nothing is recorded as an answer                              | Yes          |

"Flow support" means whether the type can be used in a **Flow-based survey**. Studies set to **In-chat survey** can use every type. See [In-chat vs WhatsApp Flows](https://docs.askyazi.com/build-a-study/in-chat-vs-whatsapp-flows.md).

When you set a question to a media or special-input type (Picture, Voice Note, Video, Document, Location and so on), Yazi adds a short instruction line such as "Please reply with a video." so participants know what to send. You can edit it.

## Choice questions in detail

### Single Select

The participant picks one answer. How it appears depends on the options:

<figure><img src="https://358667285-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FzMRQUXiGQlBwWdg6WEmG%2Fuploads%2FvWS1dAKxbl9Lins36wGl%2Fph-single-select-list.webp?alt=media&amp;token=d7fc4742-e9dc-400a-910c-a23d35821458" alt="What a participant sees: a single select question opens as a WhatsApp list"><figcaption></figcaption></figure>

| Options                                                     | Appearance                                                                |
| ----------------------------------------------------------- | ------------------------------------------------------------------------- |
| 1 to 3 short options                                        | Tappable buttons under the message                                        |
| 4 to 10 options                                             | A list the participant opens with a button, then taps one row             |
| More than 10 options, or any option too long for a list row | A lettered list (A, B, C ...) and the participant replies with the letter |

The exact length thresholds are in [WhatsApp limits](https://docs.askyazi.com/build-a-study/whatsapp-limits.md). Yazi chooses the format automatically; there is no per-question setting for it.

### Multi Select

The participant picks several answers.

<figure><img src="https://358667285-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FzMRQUXiGQlBwWdg6WEmG%2Fuploads%2FTnEg6iNZIiJYpuqKV58U%2Ffs-multiselect-editor.webp?alt=media&amp;token=c5df7242-2f17-4392-9340-17cd9cab174f" alt="A multi select question in the editor: answer options, Pipe answers from an earlier question, and minimum and maximum selections"><figcaption></figcaption></figure>

* Up to **20 options** arrive as a WhatsApp form with tick boxes and a **Back** button. The participant opens it with a **View question** button.
* Above 20 options the question becomes a lettered list and the participant replies with letters, for example "A, C, E". A lettered list has no upper limit.
* **Minimum and maximum**: set how many answers are required. "Select exactly 3" is Min 3 and Max 3; "up to 3" is Max 3 with Min blank; "at least 2" is Min 2. Answers outside the limits are re-asked with a clear message. A maximum of 1 is not allowed: use Single Select instead.

The tick-box form needs a WhatsApp number that is verified and in good standing with Meta. On an affected account the Build tab warns you, and participants may get the lettered list instead. See [Business verification](https://docs.askyazi.com/set-up-whatsapp/business-verification.md).

### Settings shared by Single Select and Multi Select

Open the question's **settings** (gear icon) to find these:

| Setting                                      | What it does                                                                                                                                                                                                             |
| -------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| **Other** (please specify)                   | Adds an "Other" option. A participant who picks it is asked to type their answer and cannot move on without typing.                                                                                                      |
| **None of the above** / **All of the above** | Adds these options with wording you can edit. They are exclusive on a multi-select: picking one alongside another option is rejected and re-asked. You can enable both on one question, and both can be used in routing. |
| **Randomise options**                        | Shuffles the option order for each participant. Click the lock icon on an option to keep it in place. Other, None of the above and All of the above stay at the bottom.                                                  |
| **Optional**                                 | Lets the participant reply "Skip". Skips are recorded as skips, separately from unanswered questions.                                                                                                                    |

Other, None of the above and All of the above each take up one option slot towards the WhatsApp limit.

Tip for "don't know" or "prefer not to say": enable **None of the above** and relabel it.

### Rating Scale and NPS

* **Rating Scale** asks for one point on a scale with labels at each end. It arrives as a tappable form.
* **NPS** is the standard 0 to 10 "how likely are you to recommend" question. It arrives as a tappable grid of all eleven points, so nobody has to type a number.

If you need to route on an NPS score (for example 0 to 6 to a detractor follow-up), a Single Select with options 0 to 10 is the simplest to route on, because each score is then an option you can pick in the logic builder.

### Matrix

A matrix asks participants to rate a list of items on one shared scale, for example rating five product features from 1 to 5.

<figure><img src="https://358667285-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FzMRQUXiGQlBwWdg6WEmG%2Fuploads%2Fi0sgTou3grHNph7Sz6ZH%2Fmatrix-editor.webp?alt=media&amp;token=a3471609-bf9f-46a4-a83e-433fa64da503" alt="A matrix question in the editor next to the Test Simulator showing how it appears on WhatsApp"><figcaption></figcaption></figure>

* **Build it** in a spreadsheet-style grid: items (rows) down the left, scale points (columns) across the top. Drag to reorder and edit in place.
* **Scale**: 1 to 5 by default. Relabel every point if you want worded labels (for example "Poor" to "Excellent"). Numeric labels need no translation; worded labels are translated like any other text.
* **Rows**: up to 10. Turn on **Randomise rows** to shuffle the row order per participant.
* **On the phone**: each item shows its full wording with the scale as a row of tappable chips under it, so a five-point scale takes one line per item. If the scale labels are too long for chips, each item gets a dropdown instead. The builder tells you which layout your question will use.
* **The confirmation** the participant sees names each row, for example "Street food: 5, Home-cooked: 3".
* **Results**: each row becomes its own column in Table Data and exports, and Graph Data charts the grid.
* **Logic and piping** work on matrix questions. See [Logic and routing](https://docs.askyazi.com/build-a-study/logic-and-routing.md) and [Piping](https://docs.askyazi.com/build-a-study/piping.md).

Every item in a matrix must use the same scale. If items need different scales, ask them as separate questions.

## Statement

A Statement sends your text with a **Continue** button and waits for the participant to tap it before the next question goes out. Use it for instructions, a consent notice, or an introduction to a block of questions about one image. You can convert a question to a Statement and back again from the type dropdown.

## Changing a question's type

Pick a new type from the dropdown. If the change would delete answer options or routing rules (for example Single Select to Text), Yazi warns you first with the exact stake, such as "Changing to Text will delete 5 answer options and 2 branching rules". Conversions that keep options, such as Single Select to Multi Select or Single Select to Matrix, happen without a warning.

## Numbering and progress

* **Builder numbering** (Q1, Q2 ...) is continuous and renumbers itself when you add, move or delete questions.
* **Participants see a progress percentage**, not "Question X of Y". In an AI interview it counts up steadily through the survey and interview sections. To hide it, turn on **Hide Question Percentage** in **Study configuration > Participant experience**.
* **Do not type counters into question text** ("Q5 of 12"). They go out of date when you change the questionnaire. The builder warns you if you do.

## Ranking questions

There is no ranking (drag to order) question type. WhatsApp has no drag interface. Two workarounds:

1. **Piping, for a true order.** Ask a Multi Select ("Which of these do you use?"), then pipe the selected options into a Single Select asking for their first choice, then ask for their second choice from the same piped list, and so on. See [Piping](https://docs.askyazi.com/build-a-study/piping.md).
2. **Rating scales, for a score on every item.** Ask a Matrix rating each item. You get a score for every item, including the low ones, rather than an order.

## Limits and things to know

* **No ranking question type.** Use the workarounds above.
* **No images as answer options.** WhatsApp cannot show pictures as tappable choices. Send the image with the question and refer to it in text options ("Pack A", "Pack B").
* **Voice Note, Video and Location cannot run inside a WhatsApp Flow.** Including any of them greys out the Flow option. See [In-chat vs WhatsApp Flows](https://docs.askyazi.com/build-a-study/in-chat-vs-whatsapp-flows.md).
* **Matrix is limited to 10 rows** and one scale. Split longer batteries into two matrices.
* **Multi Select is limited to 20 tappable options**; longer lists become lettered.
* **Answer only in one message.** On long open questions, ask participants to put their whole answer in one message.
* **Form-style questions need a verified number.** Matrix, Multi Select, Rating Scale and NPS forms depend on a verified WhatsApp account in good standing.

## Related

* [WhatsApp limits](https://docs.askyazi.com/build-a-study/whatsapp-limits.md)
* [In-chat vs WhatsApp Flows](https://docs.askyazi.com/build-a-study/in-chat-vs-whatsapp-flows.md)
* [Logic and routing](https://docs.askyazi.com/build-a-study/logic-and-routing.md)
* [Piping](https://docs.askyazi.com/build-a-study/piping.md)
* [Media in questions](https://docs.askyazi.com/build-a-study/media-in-questions.md)
* [Response quality and validation](https://docs.askyazi.com/build-a-study/response-quality-and-validation.md)
