> 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/build-a-study/quotas.md).

# Quotas

Set caps on how many participants you accept per answer option, so a study closes each group automatically when it is full.

Quotas cap how many participants you accept in each group, for example 200 men and 200 women, or no more than 100 people per region. When a group is full, the next person who falls into it is screened out at that question, so fieldwork can run unattended without one group running away while you wait for another.

{% hint style="info" %}
**In short:** set quotas in **Build > Study configuration > Quota**. Choose a **Completion target** (the total number of participants you want), mark one or more Single Select questions as quota questions, and set a cap for each answer option as a count or a percentage. Watch progress on the **Tracking** tab. Quotas work on surveys, AI interviews and diaries.
{% endhint %}

## How quotas work

1. You set a **Completion target**, the total number of participants you want.
2. You mark a **Single Select** question (for example gender, age band or region) as a quota question.
3. For each answer option you set a cap, either as a number or as a percentage of the completion target.
4. While the study is live, Yazi counts participants against each cap.
5. When an option's cap is full, the next participant who picks that option is screened out at that question and receives your screen-out message.

Caps are calculated against the completion target. If you change the target, every quota rescales.

## Set up quotas

{% stepper %}
{% step %}

### Make sure the quota questions exist

Quotas sit on **Single Select** questions. If you want age quotas, ask age as a Single Select with bands (18 to 24, 25 to 34 ...) rather than as a Number. Put quota questions early, usually in the screener, so people in a full group leave before they spend time on the survey.
{% endstep %}

{% step %}

### Open the Quota panel

On the **Build** tab, open **Study configuration** on the right and click **Quota**. Switch it on if it shows Off.
{% endstep %}

{% step %}

### Set the completion target

On the **Inputs** tab, enter the **Completion target** (TOTAL RESPONDENTS).

<figure><img src="https://358667285-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FzMRQUXiGQlBwWdg6WEmG%2Fuploads%2Fxk3OjPa68ZqoKy6djbaY%2Ffs-quota-inputs.webp?alt=media&amp;token=932a7ca4-0e45-42a2-be13-03b6098b4412" alt="Study configuration > Quota: set the completion target and pick a single-select question to use for quotas"><figcaption></figcaption></figure>
{% endstep %}

{% step %}

### Add a quota question

Click **Add quota question** and pick the Single Select question ("Pick a single-select question..."). Repeat for each question you want to control, for example gender and region.
{% endstep %}

{% step %}

### Set the caps

For each answer option, enter the cap as a count or a percentage.
{% endstep %}

{% step %}

### Publish and track

Publish the study. Open the **Tracking** tab during fieldwork to see how full each cap is.
{% endstep %}
{% endstepper %}

<figure><img src="https://358667285-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FzMRQUXiGQlBwWdg6WEmG%2Fuploads%2FiuuzKlqSSnkxw8w2P3bO%2Ffs-quota-caps.webp?alt=media&amp;token=400ecf3a-9cda-4f33-a79d-7d2156a3a382" alt="Quota caps per answer option, shown as a percentage and a count, and what happens when a quota fills"><figcaption></figcaption></figure>

## When a quota fills

By default, a participant who picks a full option is screened out at that question. They receive the screen-out message you set in **Study configuration > Privacy & screening > Screen-Out Message**. Make that message friendly: for example "Thank you, we have heard from enough people like you for now."

The Quota panel also lets you choose what happens when a quota fills. Instead of screening people out, you can accept them and flag them as over quota, so you keep their answers but can exclude them later.

People who are screened out by a full quota:

* do not count as completes;
* are skipped by automatic reminders, so you do not chase people who cannot take part;
* show as screened out on the **Share > Participants** tab.

## Quotas with paid panels

When you recruit through **Share > Panel Recruitment**, the provider's own audience criteria and quotas control who is sent to you, and your study quotas control who completes. Set both:

* Panel audience settings decide who is invited (for example country, gender, age).
* Study quotas close each group once it is full. Recruits turned away by a full quota see a clear "quota full" page and message, and Prolific is told the outcome.

See [Panel recruitment](https://docs.askyazi.com/reach-participants/panel-recruitment.md).

## Tracking quotas in your results

* The **Tracking** tab shows live progress against each cap.
* If you upload extra participant data (for example a region or customer tier) through data enrichment, those columns appear in **Graph Data** and can be cross-tabbed, which is useful for checking the mix of completes against groups that were not asked in the survey. See [Data enrichment](https://docs.askyazi.com/integrations-and-api/data-enrichment.md).

<figure><img src="https://358667285-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FzMRQUXiGQlBwWdg6WEmG%2Fuploads%2F96ixCmh58trxq8yfqscn%2Ffs-quota-tracking.webp?alt=media&amp;token=108dff96-a1d6-4e53-9c12-8c57aa572576" alt="The Quota Tracking tab: completes against the target, how many remain, and progress for each quota group"><figcaption></figcaption></figure>

## Planning tips

* **Over-recruit slightly.** Some completes will be removed in quality checks. Plan for a small buffer above your target.
* **Avoid tiny cells.** Very tight quotas on rare groups slow fieldwork down. Start recruitment for the hardest group first.
* **Interlocking quotas** (for example women aged 18 to 24 in one region) need a single question that combines the groups, or a routing design. Each quota question is capped on its own. If you need caps that combine two quota questions, ask Yazi before you field.
* **Quotas do not weight data.** They control the sample you collect. If you need weighting, export and weight in your analysis tool. See [Analysis limits](https://docs.askyazi.com/results-and-reporting/analysis-limits.md).

## Limits and things to know

* **Single Select questions only.** Multi Select, Number and text answers cannot be quota questions.
* **Quotas only count answers given in the study.** Age, gender or region held on a person's profile (from your contact list or recruitment) are not counted unless you also ask the question in the study.
* **Multi-activity studies.** Put the quota question in the activity where people qualify, usually the first. If you need a quota to count across activities, ask Yazi before you field.
* **Changing caps mid-field** applies to the next participants only. People already screened out are not brought back.
* **No built-in weighting.**

## Related

* [Screening and incidence](https://docs.askyazi.com/build-a-study/screening-and-incidence.md)
* [Logic and routing](https://docs.askyazi.com/build-a-study/logic-and-routing.md)
* [Panel recruitment](https://docs.askyazi.com/reach-participants/panel-recruitment.md)
* [Participants tab](https://docs.askyazi.com/monitor-fieldwork/participants-tab.md)
* [Analysis limits](https://docs.askyazi.com/results-and-reporting/analysis-limits.md)
