Gorilla
Support Home Questionnaire Builder 2 Objects Guide

Objects Guide

  • Overview
  • Content
  • Audio
  • Image
  • Text
  • Video
  • Questions
  • Comment Box
  • Date Entry
  • Dropdown
  • Multiple Choice
  • Multiple Choice Grid
  • Ranking Scale
  • Rating Scale
  • Slider
  • Switch Button
  • Text Entry
  • Time Entry
  • Control
  • Switch Button

Overview


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.


Info

Looking for Questionnaire Builder 1?

You can find the corresponding information in the older Questionnaire Builder 1 documentation.


Audio

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.

CONFIGURATION

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

Image


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.

CONFIGURATION

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.

Text


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

Autism Spectrum Quotient (AQ)

Patient Health Questionnaire (PHQ-9)

Generalised Anxiety Disorder (GAD 7)

CONFIGURATION

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.

Video

Display a video on the screen.

CONFIGURATION

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

Comment Box


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.

CONFIGURATION

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.

Date Entry


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.

CONFIGURATION

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.

Multiple Choice


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.

CONFIGURATION

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.

Multiple Choice Grid


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

CONFIGURATION

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

Ranking Scale


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.

CONFIGURATION

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

Rating Scale


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.

CONFIGURATION

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.

Slider


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.

CONFIGURATION

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.

Switch Button


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.

CONFIGURATION

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

Text Entry


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

Branching in Experiment

CONFIGURATION

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.

Time Entry


The Time Entry component adds 2 dropdown menus to the screen: 'Hour' and 'Minute', which participants can use to specify a time.

CONFIGURATION

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.

Switch Button


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.

CONFIGURATION

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