For the complete documentation index, see llms.txt. This page is also available as Markdown.

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.

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.

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.

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

Editing a single select question: question text, type, Add Emoji, Improve and Add Media, and the answer options

All question types

Adding a question: the + button opens the list of question types and Add block
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.

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:

What a participant sees: a single select question opens as a WhatsApp list
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. Yazi chooses the format automatically; there is no per-question setting for it.

Multi Select

The participant picks several answers.

A multi select question in the editor: answer options, Pipe answers from an earlier question, and minimum and maximum selections
  • 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.

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.

A matrix question in the editor next to the Test Simulator showing how it appears on WhatsApp
  • 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 and Piping.

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.

  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.

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