In Questionnaire Builder 2, you add functionality to the pages in your questionnaire by adding Objects. Objects generally consist of a single object, which in turn is usually either some static content (e.g some text, an image, a video) or a question (e.g. a text entry, a dropdown, and so on).
This guide lists all the different types of objects you can create.
Looking for Questionnaire Builder 1?
You can find the corresponding information in the older Questionnaire Builder 1 documentation.
The audio component allows you to add uploaded audio files to your page for participants to listen to. Each audio component allows one audio file to be played.
Samples that use this component
There are currently no samples that use this component.
Audio
The audio asset to play.
Button Label
Text for the 'Play' button
Maximum Plays
Maximum allowed number of plays. Leave blank for unlimited
Allow advance without playing
If set, the screen can advance even if audio hasn't played
Conditional
Make this element only show under certain conditions
Default State
If conditional, whether this element should be shown or hidden by default
Conditions
If conditional, the conditions under which this element should be shown or hidden
Visibility
For this condition, whether the element should be shown or hidden
Field
The field to use for this condition
Comparison
The comparison to use for this condition
Value
The value to compare to the field in this condition
This component allows you to add images to your questionnaire. Each image component allows you to display a single image.
Samples that use this component
There are curerntly no samples that use this component.
Image
Choose the image to display. This can also be bound to a Manipulation or a field in the Store. Learn more about Binding in the Binding Guide.
Max Height (px)
Set the maximum height of the image, in pixels.
Image Align
Use this setting to align the image to the left, center or right.
Conditional
Control the conditions under which this component should be shown or hidden.
Default State
If conditional, set whether this component should be shown or hidden by default.
Conditions
If conditional, the conditions under which this component should be shown or hidden.
Visibility
Select, from the dropdown, whether this component should be shown or hidden under the condition.
Field
Set the field to use for this condition.
Comparison
Select the type of comparison, from the dropdown, to make for this condition.
Value
Set the value to compare to the field in this condition.
Markdown Text components are used to display markdown-formatted text on the page. This can be used to add instructions and information text etc. You can also use this component to retrieve the participant's previous answers from the Store and display them. You can learn more about retrieving from the Store in the How-To Guide.
Samples that use this component
Patient Health Questionnaire (PHQ-9)
Generalised Anxiety Disorder (GAD 7)
Text
The markdown-formatted text that will be displayed to participants on the screen.
Base Text Size (px)
Set the size of the text, in pixels.
Text Align
Use this to align the text to the left, center or right.
Conditional
Control the conditions under which this component should be shown or hidden.
Default State
If conditional, set whether this component should be shown or hidden by default.
Conditions
If conditional, the conditions under which this component should be shown or hidden.
Visibility
Select, from the dropdown, whether this component should be shown or hidden under the condition.
Field
Set the field to use for this condition.
Comparison
Select the type of comparison, from the dropdown, to make for this condition.
Value
Set the value to compare to the field in this condition.
Display a video on the screen.
Video
The video to display.
Button Label
Text for the 'Play' button
Muted
Whether to play the video muted (muted videos will always autoplay)
Max Plays
Maximum number of times this video can be played (does not apply if controls are active)
Allow advance without playing
If set, the screen can advance even if video hasn't played
Conditional
Make this element only show under certain conditions
Default State
If conditional, whether this element should be shown or hidden by default
Conditions
If conditional, the conditions under which this element should be shown or hidden
Visibility
For this condition, whether the element should be shown or hidden
Field
The field to use for this condition
Comparison
The comparison to use for this condition
Value
The value to compare to the field in this condition
A large text area enables a large text input area for a participant to write open responses and longer answers to questions.
Samples that use this component
There are currently no samples that use this component.
Question
Type the question text for this component here.
Number of rows
Enter a number in this field to adjust the height of the Comment Box, and the amount of space participants will have to provide their answer.
Optional
If set, this question can be left unanswered.
Conditional
Control the conditions under which this question should be shown or hidden.
Default State
If conditional, set whether this component should be shown or hidden by default.
Conditions
If conditional, the conditions under which this element should be shown or hidden.
Visibility
Select, from the dropdown, whether this question should be shown or hidden under the condition.
Field
Set the field to use for this condition.
Comparison
Select the type of comparison, from the dropdown, to make for this condition.
Value
Set the value to compare to the field in this condition.
Save To Store
If set, save this response to a field in the Store. Learn more about the Store in the Binding Guide.
Destinations
The list of destinations where this response will be Stored.
Save
Choose, from the dropdown, which of this component's response fields to save to the Store.
To
Set the field in the Store which you would like to save the response to.
The Date Entry component adds 3 dropdown menus: 'Day', 'Month' and 'Year', which participants can use to specify a date. A use case for this component may be to ask participants their date of birth. The settings can be used to collect the date in months and years only, which is useful to collect GDPR compliant age data.
Samples that use this component
There are currently no samples that use this component.
Question
Type the question text for this component here.
Convert to Age
If set, interpret the participant's input as a birth date and store the number of years, months and days between that date and the current date.
Convert to Months
If set, interpret the participant's input as a birth date and store the number of months only
Month & Year Only
If set, do not store or display days in the UI. This allows you to collect a date from the participant without a day. Or, collect participant ages that are accurate to years and months, but without effectively storing dates of birth (which are often de-anonymising).
Optional
If set, this question can be left unanswered.
Conditional
Control the conditions under which this question should be shown or hidden.
Default State
If conditional, set whether this component should be shown or hidden by default.
Conditions
If conditional, the conditions under which this component should be shown or hidden.
Visibility
Select, from the dropdown, whether this question should be shown or hidden under the condition.
Field
Set the field to use for this condition.
Comparison
Select the type of comparison, from the dropdown, to make for this condition.
Value
Set the value to compare to the field in this condition.
Save To Store
If set, save this response to a field in the Store. Learn more about the Store in the Binding Guide.
Destinations
The list of destinations where this response will be Stored.
Save
Choose, from the dropdown, which of this component's response fields to save to the Store.
To
Set the field in the Store which you would like to save the response to.
A simple dropdown menu where participants select an answer from a list of options you have provided. This is useful when you wish participants to select an answer from a set of pre-defined options.
Question
Type the question text for this component here.
Use separate Responses and Labels
If set, allows you to specify separate labels (displayed to the participant) and responses (shown in your data).
Options
Add the list of options you wish to provide for this question.
Allow 'Other'
If set, adds an "Other" option to the dropdown, with a conditional text box response when selected.
'Other' option label
Label for your 'Other' option, which participants will see.
Randomise Order
Randomises the order of options within the dropdown
Optional
If set, this question can be left unanswered.
Conditional
Control the conditions under which this question should be shown or hidden.
Default State
If conditional, set whether this component should be shown or hidden by default.
Conditions
If conditional, the conditions under which this component should be shown or hidden.
Visibility
Select, from the dropdown, whether this question should be shown or hidden under the condition.
Field
Set the field to use for this condition.
Comparison
Select the type of comparison, from the dropdown, to make for this condition.
Value
Set the value to compare to the field in this condition.
Save To Store
If set, save this response to a field in the Store. Learn more about the Store in the Binding Guide.
Destinations
The list of destinations where this response will be Stored.
Save
Choose, from the dropdown, which of this component's response fields to save to the Store.
To
Set the field in the Store which you would like to save the response to.
A list of pre-defined options that a participant can choose from. If multiple answers are allowed, the options will be presented as a Checklist. If only one option can be chosen by participants, they will be displayed as Radio buttons.
Question
Type the question text for this component here.
Use separate Responses and Labels
If set, allows you to specify separate labels (displayed to the participant) and responses (shown in your data)
Allow 'Other'
If set, adds an "Other" option to the dropdown, with a conditional text box response when selected
'Other' option label
Label for your "Other" option, which participants will see.
Options
List of options for this multiple choice element
Response
The response value for this option - this is the response that will actually be stored
Label
The label for this option - this is what will be shown to the participant
Allow multiple answers
If set, allow multiple answers to be selected using checkboxes. By default, only a single answer can be selected using radio buttons.
Randomise Order
Randomises the order of options within the multiple choice
Optional
If set, this question can be left unanswered.
Conditional
Control the conditions under which this question should be shown or hidden.
Default State
If conditional, set whether this component should be shown or hidden by default.
Conditions
If conditional, the conditions under which this component should be shown or hidden.
Visibility
Select, from the dropdown, whether this question should be shown or hidden under the condition.
Field
Set the field to use for this condition.
Comparison
Select the type of comparison, from the dropdown, to make for this condition.
Value
Set the value to compare to the field in this condition.
Save To Store
If set, save this response to a field in the Store. Learn more about the Store in the Binding Guide.
Destinations
The list of destinations where this response will be Stored.
Save
Choose, from the dropdown, which of this component's response fields to save to the Store.
To
Set the field in the Store which you would like to save the response to.
Pick responses from a list of options using radiobuttons or checkboxes, arranged in a grid.
Samples that use this component
There are currently no samples that use this component
Question
The question text for this element
Use separate Responses and Labels
If set, allows you to specify separate labels (displayed to the participant) and responses (shown in your data)
Response Options (columns)
List of options for this multiple choice grid's columns
Response
The response value for this option - this is the response that will actually be stored
Label
The label for this option - this is what will be shown to the participant. You can use Markdown here to format this text, but if you want to use Markdown, you will have to tick 'Use separate Responses and Labels', as Markdown would be ignored otherwise.
Questions/Statements (rows)
List of options for this multiple choice grid's rows
Response
The response value for this option - this is the response that will actually be stored
Label
The label for this option - this is what will be shown to the participant
Allow multiple answers per row
If set, allow multiple answers to be selected using checkboxes. By default, only a single answer can be selected in each row using radio buttons.
Randomise Row Order
Randomises the order of row options within the dropdown
Show separating line between rows
If set, a horizontal line will be displayed between rows
Optional
If set, allow this question to be left unanswered.
Conditional
Make this element only show under certain conditions
Default State
If conditional, whether this element should be shown or hidden by default
Conditions
If conditional, the conditions under which this element should be shown or hidden
Visibility
For this condition, whether the element should be shown or hidden
Field
The field to use for this condition
Comparison
The comparison to use for this condition
Value
The value to compare to the field in this condition
Save To Store
If set, save this response to a field in the store.
Destinations
The list of destinations to store this response in
Save
Which of this element's response fields to save
To
The location to save this response in
A set of response options presented in a vertical list created from a list of options you provide. Participants can drag and drop to change the order of the list to provide a ranking of all the options.
Question
Here you can type the question that you'd like to ask your participant
Use separate Responses and Labels
List of options to show for the ranking
Options
Add the list of options you wish to provide for this question.
Where applicable, if you've turned on the 'Use separate Responses and Labels' setting you can further set the option that will be shown to the participant (Label) separately to the value that will be recorded in your data (Response). This is handy if one of your options is very lengthy but you want to code it in the data as a numerical value or something shorter.
Randomise Order
Randomises the order of options within the dropdown
Top Label
The label that will be shown to the top of the ranking
Bottom Label
The label that will be shown to the bottom of the ranking
Optional
If set, allow this question to be left unanswered.
Conditional
Make this element only show under certain conditions
Default State
If conditional, whether this element should be shown or hidden by default
Conditions
If conditional, the conditions under which this element should be shown or hidden
Visibility
For this condition, whether the element should be shown or hidden
Field
The field to use for this condition
Comparison
The comparison to use for this condition
Value
The value to compare to the field in this condition
Save To Store
If set, save this response to a field in the store. Learn more about the Store in the Binding Guide.
Destinations
The list of destinations to store this response in
Save
Which of this element's response fields to save
To
The location to save this response in
A set of response options presented in a horizontal line created from a list of options you provide. From these options, participants can choose a single response. This is often used when participants are asked to provide a rating based on an image or sentence.
Question
Type the question text for this component here.
Use separate Responses and Labels
If set, allows you to specify separate labels (displayed to the participant) and responses (shown in your data)
Options
Add the list of options you wish to provide for this question.
Response
Set the response value for this option. This is what will be stored in the metrics.
Label
Set the label for this option. This is what will be shown to the participant in the option list.
Left Label
The label that will be shown to the left of the scale.
Right Label
The label that will be shown to the right of the scale.
Text Size (px)
Size that will be used for the items in the rating scale.
Optional
If set, this question can be left unanswered.
Conditional
Control the conditions under which this question should be shown or hidden.
Default State
If conditional, set whether this component should be shown or hidden by default.
Conditions
If conditional, the conditions under which this component should be shown or hidden.
Visibility
Select, from the dropdown, whether this question should be shown or hidden under the condition.
Field
Set the field to use for this condition.
Comparison
Select the type of comparison, from the dropdown, to make for this condition.
Value
Set the value to compare to the field in this condition.
Save To Store
If set, save this response to a field in the Store. Learn more about the Store in the Binding Guide.
Destinations
The list of destinations where this response will be Stored.
Save
Choose, from the dropdown, which of this component's response fields to save to the Store.
To
Set the field in the Store which you would like to save the response to.
A simple slider, which allows participants to choose a value from a range. The range is 0-100 by default. This component is useful if you require participants to give an answer between a range of values, or rate something on a scale.
Question
Type the question text for this component here.
Custom Range
If set, you can choose a custom range for this slider. By default, the range is 0-100.
Minimum Value
Set a custom minimum value on the slider.
Maximum Value
Set a custom maximum value on the slider.
Start Position
If set, you can choose the starting position of the slider handle.
Starting value (min)
The minimum starting value for the slider handle. The actual position will be between this and the max value.
Starting value (max)
The maximum starting value for the slider handle. The actual position will be between this and the min value.
Add Labels
If set, you can add custom labels to the ends of the slider.
Left-side label
Choose the label to display at the left end of the slider.
Right-side label
Choose the label to display at the right end of the slider.
Advanced settings
Use these to show participants slider numbers, from the beginning or from the first click onwards only.
Show tooltip
When checked, the tooltip will display the values of the slider.
Hide handle until click
When checked, the slider handle will be hidden until the first click.
Step Size
Set the step size for the slider. Responses will be rounded to the nearest step.
Optional
If set, this question can be left unanswered.
Conditional
Control the conditions under which this question should be shown or hidden.
Default State
If conditional, set whether this component should be shown or hidden by default.
Conditions
If conditional, the conditions under which this component should be shown or hidden.
Visibility
Select, from the dropdown, whether this question should be shown or hidden under the condition.
Field
Set the field to use for this condition.
Comparison
Select the type of comparison, from the dropdown, to make for this condition.
Value
Set the value to compare to the field in this condition.
Save To Store
If set, save this response to a field in the Store. Learn more about the Store in the Binding Guide.
Destinations
The list of destinations where this response will be Stored.
Save
Choose, from the dropdown, which of this component's response fields to save to the Store.
To
Set the field in the Store which you would like to save the response to.
Allows the participant to switch to another task/questionnaire attached via a Switch Node in the experiment tree. This can be useful if you want to use a questionnaire for task instructions and enable participants to navigate between these instructions and the task.
Samples that use this component
There are currently no samples using this component.
Button Label
Text for the 'Switch' button.
Conditional
Make this element only show under certain conditions
Default State
If conditional, whether this element should be shown or hidden by default
Conditions
If conditional, the conditions under which this element should be shown or hidden
Visibility
For this condition, whether the element should be shown or hidden
Field
The field to use for this condition
Comparison
The comparison to use for this condition
Value
The value to compare to the field in this condition
The Text Entry component allows participants to enter a single line of text. The Text Entry component is useful if you wish to collect data from simple 'open', 'short-answer' questions.
Tutorials that use this component
Question
Type the question text for this component here.
Optional
If set, this question can be left unanswered.
Conditional
Control the conditions under which this question should be shown or hidden.
Default State
If conditional, set whether this component should be shown or hidden by default.
Conditions
If conditional, the conditions under which this component should be shown or hidden.
Visibility
Select, from the dropdown, whether this question should be shown or hidden under the condition.
Field
Set the field to use for this condition.
Comparison
Select the type of comparison, from the dropdown, to make for this condition.
Value
Set the value to compare to the field in this condition.
Save To Store
If set, save this response to a field in the Store. Learn more about the Store in the Binding Guide.
Destinations
The list of destinations where this response will be Stored.
Save
Choose, from the dropdown, which of this component's response fields to save to the Store.
To
Set the field in the Store which you would like to save the response to.
The Time Entry component adds 2 dropdown menus to the screen: 'Hour' and 'Minute', which participants can use to specify a time.
Question
Type the question text for this component here.
Optional
If set, this question can be left unanswered.
Conditional
Control the conditions under which this question should be shown or hidden.
Default State
If conditional, set whether this component should be shown or hidden by default.
Conditions
If conditional, the conditions under which this component should be shown or hidden.
Visibility
Select, from the dropdown, whether this question should be shown or hidden under the condition.
Field
Set the field to use for this condition.
Comparison
Select the type of comparison, from the dropdown, to make for this condition.
Value
Set the value to compare to the field in this condition.
Save To Store
If set, save this response to a field in the Store. Learn more about the Store in the Binding Guide.
Destinations
The list of destinations where this response will be Stored.
Save
Choose, from the dropdown, which of this component's response fields to save to the Store.
To
Set the field in the Store which you would like to save the response to.
Allows the participant to switch to another task/questionnaire attached via a Switch Node in the experiment tree. This can be useful if you want to use a questionnaire for task instructions and enable participants to navigate between these instructions and the task.
Samples that use this component
There are currently no samples using this component.
Button Label
Text for the 'Switch' button.
Conditional
Make this element only show under certain conditions
Default State
If conditional, whether this element should be shown or hidden by default
Conditions
If conditional, the conditions under which this element should be shown or hidden
Visibility
For this condition, whether the element should be shown or hidden
Field
The field to use for this condition
Comparison
The comparison to use for this condition
Value
The value to compare to the field in this condition