intermediate

Quota Management

Set response quotas by segment, import quota cells in bulk, download a survey codebook, and keep completes balanced across groups

13 min readUpdated October 31, 2026

Quota Management

Quota Management lets you limit how many completes you accept in each segment, for example age, region, or panel source, so your sample stays balanced as responses come in.

Where to find it

Open your survey and go to the Distribute tab. The page shows a Quota Management summary with:

  • Target Completes, your overall completion goal
  • Quota Cells, how many quota segments you have configured
  • Fill Rate, progress toward your target

Click Configure Quotas to open the full Quota Management panel.

Overview: Over target and offline overages

The Overview tab shows live fill progress for each cell.

When a cell’s completes exceed a positive Target Max, Overview marks it Over target (amber) and caps the progress bar at 100%. That can happen when interviewers field offline under a Soft lock offline quota policy, completes that went over quota while disconnected still count toward the cell.

When offline over-quota completes exist for a cell, Overview also shows N offline over quota under that cell. Soft-lock overages are already included in the cell’s Progress / current count; the offline line is the explicit flag so you can see how much of the overage came from disconnected fieldwork. See Interviewer Mode Distribution.

Export quota cells

Use Export in the Quota Management header (not inside Bulk import) to download the current cells as CSV.

  • Filename: quota-cells-<survey>.csv (survey title is sanitized for the file name)
  • Columns: Name, Target Min, Target Max, Current Completes, Quota Condition
  • Condition syntax matches bulk import (for example Q2=1 AND ED.wave="2")
  • Current Completes is read-only fill progress. Re-import ignores that column and never overwrites live completes
  • Empty setups still download a header-only CSV

Cells whose conditions use import-unsupported features (quota-cell sources, reference data, natural-language “is answered” prose, and similar) are skipped. A toast lists the skipped cell names. Edit those cells in the UI, or simplify the conditions, before exporting again.

Export is meant for offline edits: adjust targets or conditions in the CSV, then bring the file back through Bulk import.

Quota cells (and groups)

A quota cell is one segment you want to control, for example “Women 18 to 34” or “West region.” Each cell has:

  • A Cell Name
  • Target Min, a soft goal (optional)
  • Target Max, the hard cap for completes in that cell
  • Cell Logic, the conditions that put a respondent in that cell

Quota groups are how cells are organized behind the scenes. In day-to-day use you work with Quota Cells on the Quota Cells tab, create cells, set targets, and define logic. Turn quotas on or off with Quotas Enabled, then click Save Changes.

Target Max: what “0” means

Target Max of 0 means unlimited, there is no hard cap for that cell. Use Min greater than 0 with Max 0 when you want a soft goal without stopping respondents (for example Min 10, Max 0).

When Max is a positive number, Min must not be higher than Max.

Create a quota cell manually

1

On the Distribute page, click Configure Quotas.

2

Open the Quota Cells tab and create a new cell (or edit an existing one).

3

Enter a clear Cell Name, set Target Min / Target Max, and build Cell Logic from earlier questions, embedded data, Access ID data (on restricted surveys), or other available sources.

4

Turn Quotas Enabled on if you want quotas enforced for live respondents, then click Save Changes.

Respondents who match a full cell (when Max is a positive cap) are typically routed through the Quota Full end screen. See End Survey Screens.

Bulk import (CSV or Excel)

If you have many cells, import them instead of building each one by hand.

1

In Quota Management, open Quota Cells and choose Bulk import.

2

(Optional) Click Download template for a starter file.

3

Upload a .csv, .xlsx, or .xls file (Excel uses the first worksheet).

4

Review the preview. Fix or skip invalid rows, then import the valid ones.

Required columns

Headers are case-insensitive. These names (and common aliases) are accepted:

ColumnAlso accepted asWhat it is
NameCell Name, LabelThe quota cell name
Target MinMin, Minimum, target_minSoft goal
Target MaxMax, Maximum, target_maxHard cap (0 = unlimited)
Quota ConditionCondition, Conditions, Cell LogicWho belongs in the cell

Condition syntax (plain language)

Conditions are short expressions that say which answers or metadata put someone in the cell. You can refer to:

  • Question position, Q1, Q2, and so on, in full survey order (including hidden and computed questions)
  • Builder labels, the question number you set in the builder (for example H1, Region, AGE_BUCKET). Prefer these for hidden or computed questions.
  • Embedded data, ED.key="value" (also ed.key or ED:key=value)
  • Access ID data, aid.key="value" (also AID.key or ACCESS_ID.key) for fields you imported with Access IDs on a restricted survey

Common operators: = (equals), != or <> (not equals), >, <, >=, <=. Combine with AND, OR, and parentheses.

For choice questions, values can be option codes, option labels, or a 1-based position in the list. Multi-select style lists use commas (Region=5,6). Ranges like Region=1-4 expand to those codes/positions.

Examples:

Q2=1 AND Q7!=6
ED.campaign_id="spring" AND H1=1
Region>=5 AND (ed.panel=1,2 OR Charity>=1)
Region=1-4 AND Q2=1
aid.city="brampton" AND ED.wave="2"

Natural-language summaries copied from the on-screen condition builder (for example “is answered” prose), between, quota-cell sources, and reference-data sources are not supported in bulk import. Use the cell editor for those. In the cell editor you can also pick Access ID data as a condition source (same fields as aid. above).

Preview and validation errors

Each row is checked before import:

  • Invalid rows show a per-row error in the preview table
  • Only valid rows can be imported; invalid rows are skipped (not silently imported)
  • If some cells fail during Import, Quali-Fi lists the failed cell names so you can fix and retry

Common failures: missing columns, unknown Qn / builder label, unknown ED.key or aid.key, wrong option index, natural-language conditions, or Min greater than a positive Max.

Survey codebook

In the bulk import dialog, under Survey codebook, choose PDF, Word (DOCX), or JSON, then click Download codebook.

The codebook lists questions in full builder order, including hidden and computed variables, plus an Embedded Data section. Under Attribute Logic, the PDF, Word, and JSON files also print visibility rules: options, computed-list options, matrix statements and scale columns, carousel items, side-by-side items and attributes, open-end fields, and swipe cards. The sentence uses the same condition wording as ask/skip logic (Show when …). A side-by-side cell rule reads Show cell when ….

Use the codebook as a reference when writing conditions:

  • Prefer builder question numbers (for example H1) or positional Qn
  • Embedded data appears as ED.key
  • Access ID field keys are the Key values you set during Access ID import (write them as aid.key in bulk conditions). They are not listed in the codebook’s Embedded Data section, check Distribute → Access IDs or the import field settings if you need the exact key names.

The same codebook export is also available from the Survey Builder export tools.

Tips

  • Name cells clearly so reports and fill rates are easy to read later.
  • Prefer builder labels in conditions when you use hidden or computed questions, positions can shift if you reorder the survey.
  • Download the codebook before a large bulk import so option codes and embedded data keys match what you write.
  • Prefer Export over rebuilding a template when you already have cells, you get live completes alongside import-ready conditions.
  • After importing or editing, confirm Quotas Enabled and Save Changes.
  • If you later change a response to or from Submitted in Analytics, live quota fills recount. That edit does not re-fire panel redirects or triggers. See Edit response status.
  • For interviewer soft-lock fieldwork, check Overview for Over target and offline over quota after sync.

Related

Was this article helpful?