As you create your survey, you can control what each respondent sees with show/hide logic, balance logic, and other aytm Logic rules that reference demographic traits. Each trait in your Target Market is available as a reserved variable (for example, gender or age). This article lists those variables and their values.
In This Article
Before you start
-
A trait must be in your Target Market. You can only reference traits that your survey's Target Market includes. For example,
hispaniconly works in US and Puerto Rico surveys. - Values must exist for your survey's country. Some traits use different values in different countries (see Country-specific values).
-
Values are case-insensitive, so
gender = "F"andgender = "f"behave the same.
⚠️ Note: If a rule uses a trait your survey doesn't have, or a value that doesn't exist for your survey's country, the rule is flagged in red as not a valid aytm Logic rule. You must fix it before you can launch.
Multi-select traits: use in, not =
Respondents can choose more than one answer for Relationship Status, Child Age & Gender, and US Race/Ethnicity. For these traits:
-
"engaged" in relationship_statusis true for everyone who selected Engaged, whatever else they selected.relationship_status in "engaged"works the same way. -
relationship_status = "engaged"is true only for respondents who selected Engaged and nothing else.
Demographic trait reference
| Trait | Logic | Example |
|---|---|---|
|
Gender (binary) All countries except US, UK, and Canada |
gender = "f" gender = "m" |
[show if gender = "f"] |
|
Gender (non-binary) US, UK, and Canada only |
gender = "f" gender = "m" gender = "n" (Non-binary / Other) |
[show if gender = "n"] |
| Age |
age = #
(a number; also works with <, >, <=, >=) age_range = "13-17" age_range = "18-24" age_range = "25-34" age_range = "35-44" age_range = "45-54" age_range = "55-64" age_range = "65-74" age_range = "75+" |
[show if age = 18] [show if age >= 18 and age <= 34] [show if age_range = "25-34"] |
|
Country Two-letter ISO country code |
country = "US" country = "CA" country = "GB" |
[show if country = "CA" or country = "GB"] |
|
Relationship Status Multi-select |
relationship_status in "single" relationship_status in "married" relationship_status in "widowed" relationship_status in "significantother" relationship_status in "engaged" relationship_status in "divorced" |
[show if relationship_status in "engaged"] |
| Employment Status |
employment = "fulltime" employment = "parttime" employment = "freelancer" employment = "student" employment = "homemaker" employment = "retired" employment = "disabled" employment = "unemployed" |
[show if employment = "student"] |
|
Education US and Puerto Rico |
education_level = "highschool" education_level = "somecollege" education_level = "technicaldegree" education_level = "associatedegree" education_level = "bachelorsdegree" education_level = "mastersdegree" education_level = "professionaldegree" education_level = "doctoratedegree" |
[show if education_level = "bachelorsdegree"] |
|
Education Countries without their own education list (see below) |
education_level = "nocollege" education_level = "somecollege" education_level = "2yrdegree" education_level = "4yrdegree" education_level = "gradschooldegree" education_level = "professionaldegree" |
[show if education_level = "2yrdegree"] |
| Career |
career = "acc/fin/bank" See complete list of available careers |
[show if career = "adv/design"] |
|
Race/Ethnicity* US: multi-select US trait classifications Race/Ethnicity logic |
US: "whiteamerican" in race "africanamerican" in race "asianamerican" in race "nativeamerican" in race "other" in race Other countries (single-select): race = "____" |
[show if "nativeamerican" in race]
(US) [show if race = "black"] (UK) |
|
Hispanic Origin US and Puerto Rico only Learn more |
hispanic = "yes" hispanic = "no" |
[show if hispanic = "yes"] |
| Household Income* |
US: income = "0-25k" income = "25k-50k" income = "50k-75k" income = "75k-100k" income = "100k-200k" income = "200k+" Other countries use local-currency brackets. |
[show if income = "25k-50k"] [show if income = "EUR35-50k"] (Germany) [show if income = "CNY100-150k"] (China) |
|
Children in Household Number of children under 18 |
children = "0" children = "1" children = "2" children = "3" children = "4" children = "5+" |
[show if children = "1" or children = "2"] [hide if children = "0"] |
|
Child Age & Gender Multi-select |
"boy 0-12m" in children_age_and_gender "girl 2y" in children_age_and_gender Format: boy or girl, a space, then the age: 0-12m, 1y, 2y … 17y
|
[show if "boy 0-12m" in children_age_and_gender or "girl 0-12m" in children_age_and_gender or "boy 1y" in children_age_and_gender or "girl 1y" in children_age_and_gender] |
*Race/Ethnicity and Household Income values depend on the fielding country's cultural norms. See Country-specific values.
⚠️ Note: If your Target Market includes teens (13–17), teen respondents aren't asked about employment, career, relationship status, or children. A rule like
[show if employment = "student"]will never be true for them.
Country-specific values
The variable name stays the same in every country, but the values for these traits depend on the country you're fielding in:
- Education – The US and Puerto Rico use the eight levels shown above. Many other countries have their own education list with their own values. Countries without their own list use the general six-level list.
-
Race/Ethnicity – Available in the US, Puerto Rico and 35 other countries. It's labeled Race in US and Puerto Rico surveys and Race/Ethnicity elsewhere. Some countries (for example, China, France, Germany and Japan) have no race trait, so
racecan't be used there. Outside the US and Puerto Rico, respondents choose one answer, so use=. For example, the UK useswhite,asian,black,mixedandother, and Singapore useschinese,malay,indianandother([show if race = "malay"]). In the US, Multi-racial is a targeting option only; it isn't a logic value. -
Household Income – Brackets use the local currency (for example,
EUR35-50kin Germany orCNY100-150kin China). -
Gender – The non-binary option (
"n") exists only in US, UK, and Canada surveys. -
Child Age & Gender – Some accounts use an updated version of this trait that splits the first year into
0-2m,3-5m, and6-12minstead of0-12m.
💡 Tip: Not sure which values a trait uses in your survey's country? Contact support and we'll send you the list.