The qualify
decorator qualifies a respondent when a specific list option is selected.
1. Are you over 18?
type: radio
1. Yes {qualify: y}
2. No
Tip! The term
decorator is the opposite of qualify
and may be preferable to match logic specified in a client-copy of a survey. Note, the qualify: y
and term: y
decorators are opposing functions and should not be applied to the same question/variable.
Details
- Place a
qualify
decorator on an inline list option or a set list (standalone list) option to qualify any respondent who selects the option. -
The
qualify
decorator accepts 'y' or a custom text description (e.g.,qualify: Under 18
) to specify the termination reason in reports if the qualifying option is not selected. - If
qualify: y
is used, the termination reason defaults to the question text as the option description and the question ID as the option ID in reporting. - If a list with a
qualify
decorator is reused, such as a set list or a derived list, the qualification rule persists across questions unless explicitly overwritten.
Tip! For complex qualification logic or greater flexibility, use the qualifyif
tag. This is ideal for scenarios with multiple qualify
decorators and custom text, qualification logic involving multiple questions, or when you don't want qualification rules to persist across questions using the same list.
Additional examples
Customizing termination text
To customize the termination text for reports and exports, replace 'y' with your desired text. Notice that while the qualify
decorator is applied to the "correct" response, the text should describe disqualification. For example, if respondents must be 18 or older to qualify, use "Under 18 years old" as your text.
1. Are you over 18?
type: radio
1. Yes {qualify: Under 18 years old}
2. No
Comments
0 comments
Please sign in to leave a comment.