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.
Where older Yazi documentation gives a different number, the figure here is the newer one.
Questions and messages
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.
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
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
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
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
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
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:
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.