> 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/whatsapp-limits.md).

# WhatsApp limits

One reference for the WhatsApp limits that shape a Yazi study, from option counts and character lengths to media sizes and what WhatsApp cannot capture.

WhatsApp is a messaging app, not a survey tool, and Meta sets firm rules on what a business can send. This page collects every limit that affects how you write questions, in one place. Yazi's builder checks most of them as you type and flags problems in red before you publish.

{% hint style="info" %}
**In short:** keep answer options short (a few words each shows as buttons), use up to 10 options for a tappable list, up to 20 for a tick-box multi-select, and up to 10 rows in a matrix. Question text can be up to 500 characters. Some things WhatsApp simply cannot do, such as background GPS, silent recording or ranking by drag and drop.
{% endhint %}

Where older Yazi documentation gives a different number, the figure here is the newer one.

## Questions and messages

| Item                | Limit                                                               | What happens if you go over                                      |
| ------------------- | ------------------------------------------------------------------- | ---------------------------------------------------------------- |
| Question text       | 500 characters (the editor shows a counter)                         | The builder blocks saving the question                           |
| Answer option text  | 70 characters                                                       | The builder flags the option in red                              |
| Messages per answer | One. Ask for the whole answer in one message on long open questions | Extra messages may not be stored against the question you expect |

Long welcome texts and disclaimers read better split across one or more Statement questions.

## Single Select display rules

Yazi picks the format automatically from the number and length of the options. There is no setting to force one.

| Options                                                   | Format on WhatsApp                                                                | Option length                       |
| --------------------------------------------------------- | --------------------------------------------------------------------------------- | ----------------------------------- |
| 1 to 3                                                    | Tappable buttons under the message                                                | Short, a few words each             |
| 4 to 10                                                   | A list the participant opens and taps                                             | Short enough to fit on one list row |
| More than 10, or any option longer than a list row allows | Lettered list (A, B, C ...) in the message; the participant replies with a letter | Up to the 70-character option limit |

The builder warns you when an option-based question has more than 10 options, so you know it will become a lettered list.

**Tip:** if you want buttons, keep every option to a few words and put definitions or examples in the question text.

## Multi Select

| Item                                       | Limit                                                                                                                                                                                     |
| ------------------------------------------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Options in the tick-box form               | Up to 20                                                                                                                                                                                  |
| More than 20 options                       | The question becomes a lettered list with no upper limit; participants reply with letters, for example "A, C, E"                                                                          |
| Other, None of the above, All of the above | Each one counts as an option towards the limit                                                                                                                                            |
| Option text in the form                    | If every option is 70 characters or fewer, the real text is shown. If any option is longer, every option on that question shows as "Option 1, Option 2 ..." with the full text underneath |
| Maximum answers                            | Can be any number from 2 upwards. A maximum of 1 is blocked, because WhatsApp cannot open that form: use Single Select instead                                                            |
| Piped list narrowed to one option          | WhatsApp cannot show a tick-box form with a single option, so the question falls back to the lettered format                                                                              |

{% hint style="warning" %}
**Studies fielded before 8 September 2026:** multi-select questions with more than 10 options only showed the first 10 to participants. If you ran a long multi-select before that date, check the data before you use it: options past the tenth were never offered.
{% endhint %}

## Matrix

| Item                 | Limit                                                                                                       |
| -------------------- | ----------------------------------------------------------------------------------------------------------- |
| Rows (items)         | 10 per matrix. Publishing is blocked above 10. Split longer batteries into two matrices                     |
| Row (statement) text | Up to 80 characters, shown in full and wrapped onto several lines                                           |
| Scale labels         | About 20 characters each to show as tappable chips. Longer labels switch the question to a dropdown per row |
| Scale points         | No fixed cap, but keep each label short so the scale shows as chips                                         |
| Scales per matrix    | One. Items that need different scales must be separate questions                                            |
| Empty rows           | A row with its text cleared still counts towards the 10                                                     |

## Rating Scale, NPS and forms

| Item                                                           | Limit                                                                                                                       |
| -------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------- |
| NPS                                                            | 0 to 10 (11 points) as a tappable grid                                                                                      |
| Form-style questions (Matrix, Multi Select, Rating Scale, NPS) | Need a WhatsApp number that is verified and in good standing with Meta. The Build tab warns you if your account is affected |
| WhatsApp Flow screen (block) title                             | 30 characters                                                                                                               |
| WhatsApp Flow routing                                          | Forward only: a Flow can skip ahead, screen out or end, never go back                                                       |
| Where Flows show                                               | WhatsApp on mobile phones only, not WhatsApp Web or desktop                                                                 |

See [In-chat vs WhatsApp Flows](https://docs.askyazi.com/build-a-study/in-chat-vs-whatsapp-flows.md) for which question types can appear inside a Flow.

## Media

| Item                                        | Limit                                                                                                            |
| ------------------------------------------- | ---------------------------------------------------------------------------------------------------------------- |
| Photos a participant sends                  | Up to 5 MB each. Several photos in one go are accepted, including ones that arrive a few seconds late            |
| Videos and voice notes a participant sends  | Up to 16 MB                                                                                                      |
| Documents a participant sends               | Within WhatsApp's own file-size limit                                                                            |
| Images you attach to a question or template | 5 MB. Larger template header images are shrunk automatically, which can reduce quality                           |
| Documents you attach to a question          | PDF, Word, Excel, PowerPoint, TXT, CSV or ZIP, up to 100 MB. The original file name is kept                      |
| Round "instant video" selfies               | WhatsApp does not pass these to Yazi at all. The participant is told straight away to send the video another way |
| Photo captions                              | Kept and shown next to the photo                                                                                 |

## Templates and sending

| Item                      | Rule                                                                                                                                                                                                                                          |
| ------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Template names            | Lower-case letters and underscores only, for example `diary_day_2_invite`. Spaces or capitals cause Meta to reject the template                                                                                                               |
| Template approval         | Every template, and every language version of it, needs Meta's approval. Usually minutes, sometimes up to 24 hours                                                                                                                            |
| Messages outside 24 hours | Once 24 hours pass since the participant's last message, you can only reach them with an approved template. See [WhatsApp costs and the 24-hour window](https://docs.askyazi.com/reach-participants/whatsapp-costs-and-the-24-hour-window.md) |
| Daily sending limits      | Set by Meta per number and rise as the number is verified and used. See [Number health and limits](https://docs.askyazi.com/set-up-whatsapp/number-health-and-limits.md)                                                                      |
| Pace to one person        | WhatsApp refuses messages that arrive too quickly to one participant. Yazi saves and resends these automatically a few seconds later                                                                                                          |

## What WhatsApp cannot do

These are WhatsApp or Meta rules, not Yazi settings, so there is no workaround inside the platform:

| You cannot                                                     | Why, and what to do instead                                                                                                                                                         |
| -------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Capture location in the background                             | A participant must share their location themselves with a Location question                                                                                                         |
| Record audio silently                                          | WhatsApp gives no access to the phone's microphone. Ask for a voice note                                                                                                            |
| Send disappearing or view-once messages natively               | The WhatsApp Business API cannot. Yazi offers disappearing images through a separate viewer. See [Media in questions](https://docs.askyazi.com/build-a-study/media-in-questions.md) |
| Block screenshots                                              | Not possible on WhatsApp                                                                                                                                                            |
| Receive round instant-video selfies                            | WhatsApp does not deliver them. Participants are asked to send a normal video                                                                                                       |
| Use WhatsApp polls                                             | The poll feature is not part of the Business API                                                                                                                                    |
| Use images as tappable answer options                          | Send the image with the question and use text options                                                                                                                               |
| Rank by drag and drop                                          | No drag interface. See the workaround in [Question types](https://docs.askyazi.com/build-a-study/question-types.md#ranking-questions)                                               |
| Show Flow forms on WhatsApp Web or desktop                     | Ask participants to use their phone                                                                                                                                                 |
| Add participants to a group chat through the API               | The API is one-to-one. See [Group discussions](https://docs.askyazi.com/study-types/group-discussions.md)                                                                           |
| Make voice or video calls                                      | Not supported. Use voice notes and video uploads                                                                                                                                    |
| Show images that the participant's WhatsApp has not downloaded | If auto-download is off, the participant sees a blurred image until they tap it. Say in the question that an image has been sent                                                    |

## Limits and things to know

* **The builder enforces most limits.** If something is red in the builder, fix it before publishing; it will not reach participants correctly.
* **Translations can push text over a limit.** Languages that run longer than English can make options too long for buttons. Check the builder after translating.
* **Test on a real phone.** The Test Simulator mirrors WhatsApp closely, but a final check on a handset catches display differences.

## Related

* [Question types](https://docs.askyazi.com/build-a-study/question-types.md)
* [In-chat vs WhatsApp Flows](https://docs.askyazi.com/build-a-study/in-chat-vs-whatsapp-flows.md)
* [Media in questions](https://docs.askyazi.com/build-a-study/media-in-questions.md)
* [Create a broadcast template](https://docs.askyazi.com/reach-participants/broadcast-templates.md)
* [What Yazi cannot do](https://docs.askyazi.com/help/what-yazi-cannot-do-yet.md)
