Quota configuration is an expert feature. If you do not see the Quotas section in your survey settings, contact your account administrator to enable expert features for your account.
How quotas work
When you enable quotas on a survey:- A slot is reserved for each respondent who starts the survey. The slot is held for a configurable duration (the reservation window). If the respondent does not complete the survey within that window, the slot is released and becomes available again.
- Demographic screening happens after the respondent answers the screener question (or when their URL parameters are evaluated). If the quota for their segment is already full, they receive the screenout message and the survey ends.
- Overall quota caps the total number of completions regardless of segment. Once the overall target is reached, all new respondents are screened out.
Setting up quotas
Open survey settings
In the Survey Builder, click the Settings tab in the header navigation, then go to the Quotas section.
Set the overall target
Enter the maximum number of completed responses you want to collect in the Overall target field.
Choose a segmentation mode
Select how to segment respondents:
- Question — segment based on an answer to a radio-group or dropdown question in your survey.
- Variable — segment based on a URL parameter passed when the survey link is opened.
Configure per-segment targets
- Question mode: Select the screener question from the dropdown. Smartinterview automatically lists the answer options and lets you set a numeric target for each.
- Variable mode: Select the URL parameter variable, then manually add each expected value and its target count (for example,
male: 50,female: 50).
Customise the screenout message
Enter the Screenout title and Screenout message that respondents will see if their segment quota is full. Keep the message polite and informative.
Set the reservation window
The Reservation window controls how many minutes a slot is held for a respondent who started but has not yet completed the survey. The default is 30 minutes. Increase this if your survey is long; decrease it if you expect many drop-offs.
Monitoring quota progress
Once a quota is active and respondents start completing the survey, a progress panel appears below the quota configuration. It shows:- Overall progress — a progress bar with the current count against the overall target.
- Per-segment progress — individual progress bars for each segment value and its target.
- Status counters — counts of respondents currently in progress, completed, and screened out.
Screenout behaviour
When a respondent is screened out, they see the screenout message you configured. The survey ends immediately — no further questions are shown. The respondent’s session is marked asscreened_out and does not count toward the quota target.
Respondents who attempt to reopen the same survey link after being screened out are screened out again immediately, without re-entering the survey.
Best practices
- Set realistic per-segment targets that sum to the overall target. If segment targets add up to more than the overall cap, the overall cap is reached first and some segments will fall short of their individual targets.
- Use a screener question that appears early. Place your demographic screener question near the beginning of the survey so respondents are screened out before spending time on irrelevant questions.
- Test with the reservation window in mind. If you run a pilot with a small team and everyone starts the survey without completing it, slots may be held for up to 30 minutes, making the survey appear fuller than it is. Lower the reservation window during testing.
- Monitor progress regularly. Quota fill rates can vary significantly depending on the time of day and your distribution channel. Check the progress panel before and during fieldwork to catch imbalances early.

