When & Why to Use
Call standard_screener() when you need a ready-made demographic screener that:
- Adds the core demo questions (age, gender, region, etc.) in the right order
- Weights the data to national averages for the chosen country, where the selected screener supports weighting
- Closes quotas automatically once the targets are met
Use it to jump-start GenPop surveys or any study that just needs a quick, balanced sample without hand-building the screener every time.
Other Names and Formats
Standard Screeners provide demographic screeners, screening questions, and demographic profiling. General-population templates are also called general-population screeners or GenPop screeners. Any eligibility screening, weighting, or quota behavior depends on the selected country and supported template.
Supported Screeners
Standard screeners are available only for supported country and screener-name combinations:
| Country code | Available templates | Typical use-case |
|---|---|---|
| US | GenPop, NestedGenPop | General population or nested quotas |
| GB | GenPop, 16to54 | UK GenPop or younger audience |
| AU | GenPop | Australian general population |
If you need another market or audience definition, contact MX8 Labs to discuss the appropriate screener and quotas.
Function Signature
standard_screener(country: str | None = None, name: str = "GenPop", id: str | None = None) -> None
| Arg | Type | Required | Default | Description |
|---|---|---|---|---|
| country | str | None | ✗ | None | ISO-style code used by MX8 Labs ("US", "GB", "AU", ...) |
| name | str | ✗ | "GenPop" | Template name listed in Supported Screeners |
| id | str | None | ✗ | None | Optional stable identifier prefix for the generated screener questions; if not set, each question's text is used |
What the screener adds
The selected template adds its demographic questions and applies the associated quota targets. You can add other survey steps before or after the screener.
Example Code
# US general population survey
s.standard_screener("US")
# UK younger audience, ages 16-54
s.standard_screener("GB", "16to54")
# Nested quotas in a US screener
s.standard_screener(country="US", name="NestedGenPop")
# Stable identifier prefix for the generated screener questions
s.standard_screener(country="US", id="screener")
Notes & Tips
- Add other survey steps before or after the screener; order does not matter.
- Calling the same screener twice does not add a duplicate set of questions.
- Questions are locally adapted, such as using the appropriate ethnicity list for each market.
That's it. One line, instant screener weighted to national averages.