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

Live Forms

What a Live Form is, when you might use one, and how it differs from a WhatsApp survey. Early access.

A Live Form is a web version of a Yazi survey. The participant opens it in a browser, usually from a link or button in their WhatsApp chat, and answers on form screens instead of message by message. It suits audiences arriving from a panel or an ad, where you want the speed of a form but still want WhatsApp for invites and follow-up.

In short:

  • A Live Form uses the same builder as a survey. Where it is switched on for your organisation, you choose it in Study configuration > Participant experience > Builder Mode ("A web form participants open from a link, with a WhatsApp-style chat"). It shows on the Dashboard with the type Live Form.

  • When you choose Live Form, a short setup window asks for the introduction participants see first, confirms the language, and offers a limit on repeat answers. It also gives you the participant link.

  • The Share link window gives one form link and a QR code that anyone can open on their phone, plus a separate test link. People who close the form and come back carry on where they left off.

  • Some features behave differently from a WhatsApp survey. Test the full journey, including how people are paid, before you field.

Choosing Live Form in Participant experience opens Set up your Live Form: the introduction, language, the limit on repeat answers and the participant link

What differs from a WhatsApp survey

A Live Form on a phone: progress at the top, a reminder that the participant can come back later, and the first question as tappable options
WhatsApp survey
Live Form

Where questions appear

In the WhatsApp chat, or in a WhatsApp Flow

On web form screens in a browser

Question types

Chosen in the builder, shown as WhatsApp messages or Flow screens

Chosen in the same builder, shown as form fields. Try each question type in a test run before fieldwork

Completion message

Sent in the chat

Shown on the form, sent on WhatsApp afterwards, or both

Returning later

Carries on in the chat

Reopening the form link carries on where they left off

Invites

Study link, QR code or broadcast

Usually a WhatsApp broadcast; the participant taps through to the form

A Live Form multi-select question with an image above it: tick the options, then Send

Things you can set

  • Completion message. Choose whether it shows in the form, is sent on WhatsApp, or both. Approved templates are supported for the WhatsApp route.

  • Limit repeat answers. One answer per device, and at most 3 from the same internet connection. People who start from WhatsApp already get one answer per number.

  • Piping. Live Form questions can offer answer options from an earlier question.

  • Screen-out messages appear in the participant's language.

Testing and resetting

In Share > Share link, open Need a test link? and use that link while you build. Answers through the test link are left out of your results. Answers through the main form link are counted, so do not use it for testing.

Share link on a Live Form: one form link anyone can open on their phone, a QR code, and a separate test link under Need a test link?

If participants start from WhatsApp, send the study's starter phrase with -TEST added to the end to clear your own session and start again.

Limits and things to know

  • Availability. Live Forms must be switched on for your organisation. You cannot convert a study to a Live Form until it is.

  • Rewards. Check that rewards pay out correctly on a Live Form during testing before you rely on them.

  • Answers from the main link count. If anyone tests through the main form link, clear those answers before fieldwork.

  • Network access. Participants open Live Forms at forms.askyazi.co. A corporate network may need to allow that address. See Network allow-listing.