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

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.

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.

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

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

Daily sending limits

Set by Meta per number and rise as the number is verified and used. See Number health and limits

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

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

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

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.