> 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/study-types/live-forms.md).

# Live Forms

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

{% hint style="warning" %}
**Early access.** Live Forms are not yet generally available. If you would like to use them, for example with a paid panel, contact Yazi through **Feedback & Support** or see [Get help](https://docs.askyazi.com/help/get-help.md).
{% endhint %}

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.

{% hint style="info" %}
**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.
  {% endhint %}

<figure><img src="https://358667285-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FzMRQUXiGQlBwWdg6WEmG%2Fuploads%2F2m1naVuLxkfitnOGCko8%2Ffs-live-form-setup.webp?alt=media&amp;token=9d9650ec-bd65-41d8-b2ef-4a5c3e3541d3" alt="Choosing Live Form in Participant experience opens Set up your Live Form: the introduction, language, the limit on repeat answers and the participant link"><figcaption></figcaption></figure>

## What differs from a WhatsApp survey

<figure><img src="https://358667285-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FzMRQUXiGQlBwWdg6WEmG%2Fuploads%2FnaClHpGsIwfzt9yVsLPt%2Fph-live-form-start.webp?alt=media&amp;token=d6a84d2e-7f40-4f70-a876-76b12b329ea2" alt="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"><figcaption></figcaption></figure>

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

<figure><img src="https://358667285-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FzMRQUXiGQlBwWdg6WEmG%2Fuploads%2FDD9DcOXLx5zHckKDaADC%2Fph-live-form-multi.webp?alt=media&amp;token=4bf26c16-0ff1-4cb4-adb0-4ce3286640d6" alt="A Live Form multi-select question with an image above it: tick the options, then Send"><figcaption></figcaption></figure>

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

<figure><img src="https://358667285-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FzMRQUXiGQlBwWdg6WEmG%2Fuploads%2FiUzuCinypvH5osDgB58v%2Ffs-live-form-share.webp?alt=media&amp;token=a883acbb-6153-4409-8450-44952120a73d" alt="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?"><figcaption></figcaption></figure>

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](https://docs.askyazi.com/set-up-whatsapp/network-allow-listing-for-corporate-it.md).

## Related

* [Surveys](https://docs.askyazi.com/study-types/surveys.md)
* [Panel recruitment](https://docs.askyazi.com/reach-participants/panel-recruitment.md)
* [Group discussions](https://docs.askyazi.com/study-types/group-discussions.md)
* [Test your study](https://docs.askyazi.com/study-types/test-your-study.md)
