> 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/multi-activity-studies.md).

# Multi-activity studies

Build a study with several activities, control when each one unlocks, and understand exactly how participants move from one activity to the next.

A multi-activity study links two or more activities (surveys, AI interviews, recurring surveys, and group discussions where your organisation has early access) into one study that a participant moves through in the same WhatsApp chat. Use it when your research changes over time or needs different methods at different stages: a baseline survey, then a week of diary entries, then a closing AI interview.

{% hint style="info" %}
**In short:**

* Each participant moves at their own pace. The unlock time you set for an activity is the **earliest** it can open for someone, counted from when they finish the previous activity.
* Nobody is skipped. A participant who has not finished the current activity waits on it. If the unlock time has already passed when they finish, the next activity opens straight away.
* After saving, re-open each activity and check its unlock date and time.
  {% endhint %}

## How a multi-activity study is organised

* The study has one title and one set of languages. On the Dashboard it shows with the type **Study** and "N activities" under the title.
* Each activity has its own questions, settings and format (in-chat or WhatsApp Flow), built in its own builder. On the **Build** tab, the **ACTIVITIES** panel on the left lists every activity with its type. Click an activity to open it. Between each pair of activities is a timing chip showing when the next one unlocks.
* All activities are linked by participant, so you can analyse each activity on its own or follow one person across the whole study.
* A study with one activity is simply a study. Once it has two or more, it is a multi-activity study.

<figure><img src="https://358667285-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FzMRQUXiGQlBwWdg6WEmG%2Fuploads%2FjBZ4U8i77qpi7P74eIwb%2Fmulti-activity-build.webp?alt=media&amp;token=aa8e2a18-1095-485e-92d3-327a89070db1" alt="The Build tab of a multi-activity study with the Activities list on the left"><figcaption></figcaption></figure>

**Common shapes**

| Shape                              | Example                                                                                                                                                            |
| ---------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| Survey, then diary, then interview | Baseline habits, five days of logging, then an AI interview on what changed                                                                                        |
| Before, during, after              | Expectations survey, in-store task with photos, follow-up survey                                                                                                   |
| Interview, survey, interview       | Explore expectations, measure what happened, reflect on change                                                                                                     |
| Sections as activities             | Each section of a long questionnaire as its own activity, followed by 3 to 5 AI follow-up questions on that section, with the next section unlocking straight away |

## Create the study and add activities

{% stepper %}
{% step %}

### Create the study

Click **+ New Research**. With **Build with AI**, upload a brief and Yazi proposes the activities. With **Build manually**, set **STUDY TYPE** to **Multi-activity** and pick a research method for the first activity. See [Create a study](https://docs.askyazi.com/build-a-study/create-a-study.md).
{% endstep %}

{% step %}

### Add each activity

Click **+ Add activity** at the bottom of the **ACTIVITIES** panel, give it a name, pick the research method (Survey, Interview, Recurring or Group Discussion) and, where relevant, the format. When you add an AI interview, you also choose whether its short survey part runs in-chat or as step-by-step WhatsApp Flow screens.

Name activities so participants and colleagues can tell them apart, for example "Day 1: Your routine" rather than "Activity 1".
{% endstep %}

{% step %}

### Build each activity

Open each activity and build it as you would a single survey, interview or recurring survey. Each activity can use a different format, so a survey can run as a fast WhatsApp Flow while the diary that follows runs in-chat to collect voice notes. See [In-chat vs WhatsApp Flow](https://docs.askyazi.com/build-a-study/in-chat-vs-whatsapp-flows.md).
{% endstep %}

{% step %}

### Set when each activity unlocks

For every activity after the first, click the timing chip above it in the **ACTIVITIES** panel and choose when it opens, plus the invite that announces it. See the next section.
{% endstep %}

{% step %}

### Set languages once, for the whole study

Languages belong to the study, not to individual activities. See [Languages and translation](https://docs.askyazi.com/study-types/languages-and-translation.md).
{% endstep %}
{% endstepper %}

{% hint style="warning" %}
New activities start out set to **Right away · 0–5 mins**, as the timing chip shows. If you want a day-by-day study, set each activity's schedule yourself before you go live.
{% endhint %}

## When each activity unlocks

Click the timing chip between two activities to open **When it unlocks**, which controls when the next activity is sent. Choose:

* **Right away · 0–5 mins**: the activity opens within about five minutes of the participant finishing the previous one.
* **On a schedule**: the activity opens at a time you set.

<figure><img src="https://358667285-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FzMRQUXiGQlBwWdg6WEmG%2Fuploads%2FoHD8Xk9Bu9eTJ0UYt4qi%2Fwhen-it-unlocks.webp?alt=media&amp;token=592852db-d56a-4339-8a09-142e0053ba4d" alt="The When it unlocks popover between two activities, offering Right away or On a schedule"><figcaption></figcaption></figure>

For the full set of options, click **Open full schedule editor →**. Under **When it goes out** you choose:

| Option                                                  | What happens                                                                                                                            |
| ------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------- |
| **After completion**, **The same day**, at a time       | Opens at the time you pick on the day the participant finishes the previous activity, or straight away if that time has already passed. |
| **After completion**, **The next day**, at a time       | Opens at the time you pick on the following day, for example 9am.                                                                       |
| **After completion**, a number of days later, at a time | Opens at the time you pick after the gap you set.                                                                                       |
| **Specific date** (date, time and time zone)            | Opens on that date, or straight away for anyone who finishes the previous activity after it.                                            |

<figure><img src="https://358667285-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FzMRQUXiGQlBwWdg6WEmG%2Fuploads%2F8X6PDGNWzX7daYn3WmGj%2Fschedule-after-completion.webp?alt=media&amp;token=828106a8-9372-4155-b34c-dd4e8fd7b8d6" alt="The schedule editor with the after-completion timing options open"><figcaption></figcaption></figure>

The schedule editor is also where you choose the invite message (see [Invites between activities](#invites-between-activities)) and whether to include an opt-out button. A preview shows the participant's WhatsApp message, for example "Your next activity is ready" with **Continue** and **Opt out** buttons.

There is no unlock option that waits for you to move people by hand, but you can move any participant on yourself from the **Share** tab (see [Moving individual participants](#moving-individual-participants)).

### How progression works for each participant

This is the most important rule to understand, and the one most often misread:

1. **Everyone moves at their own pace.** Progression is counted per participant, from the moment that person finishes the previous activity. It is not a single start date for the whole group.
2. **The unlock time is the earliest possible time, not a fixed send time.** If Activity 2 is set to "next day at 9am" and a participant finishes Activity 1 on Tuesday at 8pm, Activity 2 opens for them on Wednesday at 9am.
3. **People who have not finished wait.** A participant still on Activity 1 does not receive Activity 2, however much time passes. They are not skipped.
4. **Late finishers catch up straight away.** If the unlock time has already passed when someone finishes, the next activity opens for them immediately (allow up to about 5 minutes).
5. **One activity per day on daily schedules.** A participant who falls behind on a daily diary cannot complete two days at once. See [Diary and recurring studies](https://docs.askyazi.com/study-types/diary-and-recurring-studies.md#catch-up-rules).

So at any moment, different participants can be on different activities. That is expected. The **Share** tab shows where each person is.

{% hint style="warning" %}
**Re-check dates after saving.** If you need an activity to open on a specific date rather than "the next day", set it explicitly and then re-open the schedule after saving to confirm it stuck. If a date does not save, participants can receive later activities earlier than you planned.
{% endhint %}

## Invites between activities

When a scheduled activity unlocks, the participant first receives an **invite**: an approved WhatsApp broadcast template with a **Continue** button. The first question arrives only when they tap **Continue**.

* In the schedule editor, use an approved broadcast or write a new one (a new one goes to Meta for approval).
* The invite must be an **approved** template with a **Continue** button. You can use any approved broadcast that has one. Templates that contain variables are not offered here. See [Broadcast templates](https://docs.askyazi.com/reach-participants/broadcast-templates.md).
* A study cannot go live while a scheduled activity's invite lacks a **Continue** button.
* Each template needs Meta approval, which can take from about 10 minutes to 24 hours. Create invites early. If your study runs in several languages, each language needs its own approved template.
* Activities set to **Right away · 0–5 mins** do not need an invite. They start straight after the previous activity ends.

**Why an approved template?** WhatsApp only lets a business send free-form messages within 24 hours of the participant's last message. A diary day that unlocks at a fixed time often falls outside that window, so it must start 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).

**Backup broadcasts.** On any step of a study you can set a backup broadcast. Yazi uses it automatically when the normal in-chat message cannot be delivered, for example because the 24-hour window has closed. If the window is closed and no backup is set, the send is shown as not delivered rather than as sent.

### What participants see between activities

* At the end of each activity they receive that activity's completion message, before the next activity starts.
* If they message during the gap, they are told they are still taking part and will be messaged when the next activity is ready. Anything they send in the gap (text, photo, location) is stored, not discarded.

## Language is asked once

In a multi-language study, participants choose their language at the start of the first activity, and every later activity runs in that language without asking again. They are only asked again if a later activity does not offer the language they chose. See [Languages and translation](https://docs.askyazi.com/study-types/languages-and-translation.md).

## Moving individual participants

Open the **Share** tab and use the Progression menu on a participant:

| Action           | What it does                                                                                         |
| ---------------- | ---------------------------------------------------------------------------------------------------- |
| **Push**         | Sends the participant their next activity now, or the day they are actually waiting for on a diary.  |
| **Set activity** | Moves the participant to a specific activity.                                                        |
| **Hold**         | Pauses the participant's schedule. Held participants show a **Held** pill, and you can filter by it. |
| **Resume**       | Returns a held participant to their original schedule without sending anything immediately.          |
| **Reset**        | Clears the participant's progress so they start again. Use with care.                                |

Removing a participant from the study clears their responses, completed activities, queued messages and enrolment across the whole study. They stay in your People list and can be added again, starting fresh. See [Participants tab](https://docs.askyazi.com/monitor-fieldwork/participants-tab.md).

## Send a broadcast to one activity

When you send a broadcast from a study, you can pick the whole study or a single activity, for example to chase everyone who has not finished Activity 2. Filter the **Share** tab by **In survey**, select those people and send. See [Send a broadcast](https://docs.askyazi.com/reach-participants/send-a-broadcast.md) and [Reminders](https://docs.askyazi.com/reach-participants/reminders.md).

## Testing a multi-activity study

Test each activity on its own with the Test Simulator, then test the whole journey on a real phone. To run end to end without waiting for real unlock times, temporarily set each activity to **Right away · 0–5 mins**, test, then restore the real schedule before going live. Run Simulation can also walk simulated participants through every activity. See [Test your study](https://docs.askyazi.com/study-types/test-your-study.md).

## Results

* Each activity has its own results on the **Responses** and **Reporting** tabs, with the same toolbar (export, cross-tabs, PPT) as a single survey.
* The **Media Library** covers every activity, grouped by activity and question.
* Exports wait until every activity has loaded and refuse with an error rather than writing a short file.
* A study's shared results link shows every activity.

## Limits and things to know

* **Piping does not cross activities.** A question can only use answers from earlier questions in its own activity. See [Piping](https://docs.askyazi.com/build-a-study/piping.md).
* **No routing from one activity into another based on answers.** Cohort splits are made with logic inside an activity, or by inviting each group into its own study.
* **A multi-activity study cannot be turned back into a single activity.** If the AI uploader splits your questionnaire into several activities when you wanted one, rebuild it or ask Yazi for help.
* **Individual activity links do not work while the study is in Testing.** Testers start at the first activity.
* **Activities count separately for billing.** Each activity a participant starts counts. See [Plans, billing and usage](https://docs.askyazi.com/start-here/plans-billing-and-usage.md).

## Related

* [Diary and recurring studies](https://docs.askyazi.com/study-types/diary-and-recurring-studies.md)
* [Broadcast templates](https://docs.askyazi.com/reach-participants/broadcast-templates.md)
* [Reminders](https://docs.askyazi.com/reach-participants/reminders.md)
* [Participants tab](https://docs.askyazi.com/monitor-fieldwork/participants-tab.md)
* [Test your study](https://docs.askyazi.com/study-types/test-your-study.md)
* [Publish and go live](https://docs.askyazi.com/study-types/publish-and-go-live.md)
