Questionnaire Widgets


Overview


Welcome to the Questionnaire Widget Tooling Reference Guide.

Here you can find out information on how and when to use a particular Questionnaire Widgets. There are 18 Widgets available, browse the list in the menu on the left to find out more information about each one.

Questionnaires consist of blocks of Rich Text content (which can be a mixture of Markdown and/or HTML) and Response widgets, which offer a range of ways for participants to be asked questions.

If you are looking for more information on questionnaires in general take a look at our 'How To: Questionnaires' Guide.


Tooling Reference Guide Format:


For each Questionnaire Widget listed you will find a description of the Widget and an image example. This will be followed by a live Demo of the Widget. Finally a configuration settings box (like the one below) will list and explain all available configuration settings for the selected Widget.

Most widgets offer three common configuration settings:

Configuration Settings:

Key

This is the key that identifies this response in your metrics data. As the label or question for a widget may not directly identify which question it pertains to, the key gives you an opportunity to set the name of the response in your data.

Keys should be unique across the questionnaire - no two responses should have the same key. Keys will automatically be populated with generic values (response-1, response-2, ...) but you can change them to more meaningful values to make your data analysis easier.


Write to Embedded Data

If checked, the response to this question will also be written to the participant's embedded data, allowing you to retrieve and use it later in your experiment. To retrieve this data later within your experiment you must use the same key as specified above.


Allow Missing

If checked, this question does not need to be answered in order to progress. By default, all questionnaire questions need to be responded to, but you can elect to allow some questions to go unanswered.

Click the Tutorial icon to view a Tutorial which explains how to set up and use the selected Questionnaire Widget.

Click the Example icon to view an example of a Sample which makes use of the selected Questionnaire Widget.

Rich Text Widget


Rich Text Widgets are the most common widget in questionnaires. Rich Text widgets are designed to be the main content block of your questionnaire, with the other widgets specific to individual responses.

You can use Rich Text Widgets in your questionnaires to add instructions and information text, etc.

Rich Text Widgets support content written in Markdown and/or HTML. You can use them to add formatted text to your questionnaires, or embed your own HTML.

Configuration Settings:

-- No Settings --

Click to view a Tutorial of the Rich Text Widget.

Click to view a Classic 'Consent' Example which makes use of the Rich Text Widget.

Image Widget


You can use the Image Widget to add image content into your questionnaire. This may be useful for presenting stimuli or perhaps instructions that are in an image format.

Each Image Widget allows you to upload a single image, which is then hosted within Gorilla.

Configuration Settings:

Change (Button)

Click this button to bring up the Upload dialog-box, then browse for the file you wish to upload.

You will see a preview of the Image. Press the green 'Upload' button to complete the process. Otherwise select the orange 'Choose another' option to pick a different image.

Click to view a Tutorial of the Image Widget.

Click to view an Example of a Sample Project which makes use of the Image Widget.

Page Break Widget


A Page Break Widget allows you to separate out your questions across multiple pages.

All widgets after the page break will be shown on the next page.

As you can see in the example below. The Page Break Widget is a Layout Widget which means unlike other widgets the configuration options are not located in the Page Break Widget itself.

Locate the configurations settings in the questionnaire builder main Settings, under the Options Menu.

Configuration Settings:
* Locate these in the main Settings Options,

Next Button Label

Default = 'Next'

Rename the Next button Label.


Show Back Button

Checking this Box will enable the Back Button to appear on your pages. This will allow participants to go to the previous page.

If enabled only a participant's final response will be recorded: e.g. if they initially answer a question with the response 'cat', and then go back and change it to 'dog', only 'dog' will be recorded in your metrics spreadsheet.


Back Button Label

Default = 'Back'

Rename the Back button Label. (note: you must have also checked the 'Show Back Button' option in order to see this button.)

Click to view a Tutorial of the Page Break Widget.

Text Entry Widget


A simple Text Entry Widget.

The Text Entry Widget additionally prevents all standard browser auto-functions.
Specifically these are:

  1. Auto-Correct
  2. Auto-Complete
  3. Auto-Capitalise
  4. Spell-Check

All the above browser functions will be turned off when entering content into a Text Entry Widget. This means when participants are entering answers they will not be assisted by these browser technologies.

The Text Entry Widget is useful for when you wish to collect data from a simple 'open' 'short-answer' question such as in the example below.

Configuration Settings:

Question Text

This text is presented directly above the text input box.


Key

This is the key name that identifies this response in your metrics data. We highly recommend you change this to a more meaningful name (see image example above) to make your data analysis easier.

Note: Keys should be unique across the questionnaire - no two responses should have the same key.


Write to Embedded Data

If checked, a participants response to this question will be written to the participant's embedded data, allowing you to retrieve and use it later in your experiment.

To retrieve this data later within your experiment you must use the same key as specified above.


Allow Missing

If checked, the participant does not need to answer this question in order to progress.

Click to view a Tutorial of the Text Entry Widget.

Comment Box Widget


A large text area which allows the participant to enter an arbitrary amount of text.

The Comment Box Widget additionally prevents all standard browser auto-functions.
Specifically these are:

  1. Auto-Correct
  2. Auto-Complete
  3. Auto-Capitalise
  4. Spell-Check

All the above browser functions will be turned off when entering content into a Comment Box Widget. This means when participants are entering answers they will not be assisted by these browser technologies.

The Comment Box Widget is useful for when you wish to collect data from an 'open' 'long-answer' question such as in the example below.

Configuration Settings:

Question Text

This text is presented directly above the comment box.


Key

This is the key name that identifies this response in your metrics data. We highly recommend you change this to a more meaningful name (see image example above) to make your data analysis easier.

Note: Keys should be unique across the questionnaire - no two responses should have the same key.


Allow Missing

If checked, the participant does not need to answer this question in order to progress.

Click to view a Tutorial of the Comment Box Widget.

Checklist Widget


A set of checkboxes is created from the options you list, from these your participants can pick as many as they like.

Each checkbox that the participant selects from the checklist will come through in the metrics as an individual response in its own row.

Configuration Settings:

Question Text

This text is presented directly above the checkboxes.


Options

Type here the list of options you want to offer. Be sure each option is separated by commas.


Include Text Entry Option

If Checked adds an 'Other' checkbox to the end of your list of checkbox options. When the participant selects this option they will be presented with a text entry box participants into which they can enter any response.


Prompt for Text Entry Option

Type here the Prompt for the text entry option. Default = 'Other (please specify)'.


Key

This is the key name that identifies this response in your metrics data. We highly recommend you change this to a more meaningful name (see image example above) to make your data analysis easier.

Note: Keys should be unique across the questionnaire - no two responses should have the same key.

Click to view a Tutorial of the Checklist Widget.

Radio Buttons Widget


A set of radio buttons is created from the list of options you provide, of which the participant can only pick one.

The Radio Button Widget is useful for questions with 'mutually exclusive' answers. i.e. where you want to force your participant to select only one option.

When using the Radio Button Widget you will get an additional row in your metrics - alongside the standard entry under the 'Question Key' & 'Response' columns - which represents the quantised version of your participants answer.
Quantised numbering starts at 1, corresponding to the first option you enter in the options field.

Configuration Settings:

Question Text

This text to presented directly above the radio buttons.


Options

Type here the list of options you want to offer. Be sure each option is separated by commas.


Include Text Entry Option

If Checked adds an 'Other' radio button to the end of your list of radio button options. When the participant selects this option they will be presented with a text entry box participants into which they can enter any response.


Prompt for Text Entry Option

Type here the Prompt for the text entry option. Default = 'Other (please specify)'.


Key

This is the key name that identifies this response in your metrics data. We highly recommend you change this to a more meaningful name (see image example above) to make your data analysis easier.

Note: Keys should be unique across the questionnaire - no two responses should have the same key.


Write to Embedded Data

If checked, a participants response to this question will be written to the participant's embedded data, allowing you to retrieve and use it later in your experiment.

To retrieve this data later within your experiment you must use the same key as specified above.

Note: If you wish to overwrite the standard numbering with your own scoring use the embedded data key 'yourKeyNameHere-quantised'. Check out the Scripting in the Questionnaire Walkthrough for more information on this.


Allow Missing

If checked, the participant does not need to answer this question in order to progress.

Click to view a Tutorial of the Radio Button Widget.

Click to view a Classic Demographics Questionnaire Example which makes use of the Radio Button Widget.

Mixed Entry Widget


The Mixed Entry Widget consists of a Text Entry widget and a set of radio buttons, which are created from the list of options you provide. Of these the participant can either enter a value into the text entry or pick an option from the radio buttons.

The Mixed Entry Widget is useful for questions where you wish the participant to enter an open (unprompted) value or else select an option from a set of fixed options.

Configuration Settings:

Question Text

This text to presented directly above the Text Entry box.


Options

Type here the list of options you want to offer as Radio Buttons. Be sure each option is separated by commas.


Key

This is the key name that identifies this response in your metrics data. We highly recommend you change this to a more meaningful name (see image example above) to make your data analysis easier.

Note: Keys should be unique across the questionnaire - no two responses should have the same key.


Write to Embedded Data

If checked, a participants response to this question will be written to the participant's embedded data, allowing you to retrieve and use it later in your experiment.

To retrieve this data later within your experiment you must use the same key as specified above.


Allow Missing

If checked, the participant does not need to answer this question in order to progress.

Click to view a Tutorial of the Mixed Entry Widget.

Click to view a Classic Demographics Questionnaire Example which makes use of the Mixed Entry Widget.

Date Entry Widget


The Date Entry Widget adds a set of 3 dropdown menus for, 'Day', 'Month' and 'Year' which the participant can use to specify a date.

The Date Entry Widget is useful when you wish participants to specify a date in the form of 'day, month and year'.

Click Here To View A Live Demo of the Date Entry Widget

Please Enter your Date of Birth:

Configuration Settings:

Question Text

This text to presented directly above the date entry dropdowns.


Key

This is the key name that identifies this response in your metrics data. We highly recommend you change this to a more meaningful name (see image example above) to make your data analysis easier.

Note: Keys should be unique across the questionnaire - no two responses should have the same key.


Write to Embedded Data

If checked, a participants response to this question will be written to the participant's embedded data, allowing you to retrieve and use it later in your experiment.

To retrieve this data later within your experiment you must use the same key as specified above.

Click to view a Tutorial of the Date Entry Widget.

Click to view a Classic Demographics Questionnaire Example which makes use of the Date Entry Widget.

Time Entry Widget


The Time Entry Widget adds a set of 2 dropdown menus for 'Hour' and 'Minute' which the participant can use to specify a time.

The Time Entry Widget is useful when you wish participants to specify a time in a 24 hour clock.

Click Here To View A Live Demo of the Time Entry Widget

Please enter the time at which you usually wake up:

Configuration Settings:

Question Text

This text to presented directly above the time entry dropdowns.


Key

This is the key name that identifies this response in your metrics data. We highly recommend you change this to a more meaningful name (see image example above) to make your data analysis easier.

Note: Keys should be unique across the questionnaire - no two responses should have the same key.


Write to Embedded Data

If checked, a participants response to this question will be written to the participant's embedded data, allowing you to retrieve and use it later in your experiment.

To retrieve this data later within your experiment you must use the same key as specified above.

Click to view a Tutorial of the Time Entry Widget.

Email Entry Widget


The Email Entry Widget creates a text entry box with an email prompt, into which the participant can enter an email address.

The Email Entry Widget will require that the participant enter text in the form of the prompt i.e. 'something@somethingelse', however it will not be able to verify if the email is real/correct or not.

The Email Entry Widget is useful when you wish to collect email address for contact purpose in your questionnaire.

Configuration Settings:

Question Text

This text to presented directly above the Email Entry box.


Key

This is the key name that identifies this response in your metrics data. We highly recommend you change this to a more meaningful name (see image example above) to make your data analysis easier.

Note: Keys should be unique across the questionnaire - no two responses should have the same key.


Write to Embedded Data

If checked, a participants response to this question will be written to the participant's embedded data, allowing you to retrieve and use it later in your experiment.

To retrieve this data later within your experiment you must use the same key as specified above.


Allow Missing

If checked, the participant does not need to answer this question in order to progress.

Click to view a Tutorial of the Email Entry Widget.

Click to view a Classic Demographics Questionnaire Example which makes use of the Email Entry Widget.

Slider Widget


A simple slider, which allows the participant to choose a value from a range. The range defaults to 0 - 100.

The Slider Widget is useful for questions which require a participant to give an answer between a range of values or to rate something on a scale.

Note: If you wish to use embedded data in conjunction with this style of question use the Rating Scale/Likert instead.

Configuration Settings:

Question Text

This text is presented directly above the slider.


Left End

Label for the left end of the slider.


Right End

Label for the right end of the slider.


Tooltip

If checked a tooltip, which displays the integer value of the sliders current position, will be shown above the slider.


Start

Enter a value of the position the slider should start at.

This value must be between the Min and Max values assigned to the slider. The default values of the slider are Min = 0, and Max= 100, in which case if we want the slider to start in the centre we would assign Start the value of 50.


Min

Set the minimum value for the slider. This is the value of the left end of the slider.


Max

Set the maximum value for the slider. This is the value of the right end of the slider.


Key

This is the key name that identifies this response in your metrics data. We highly recommend you change this to a more meaningful name (see image example above) to make your data analysis easier.

Note: Keys should be unique across the questionnaire - no two responses should have the same key.

Click to view a Tutorial of the Slider Widget.

Rating Scale/Likert Widget


A set of items arranged in a horizontal line is created from the list of options you provide, from these the participant can choose only one response.

Their are two main styles used in setting up the likert:

  1. Make use of the Options setting to write full name labels (see Image Example & Live Demo below)
  2. Make use of the Left End and Right End label settings and instead use a set of numbers under the Options setting. (see Demo and Example page links)

Style 1 can be useful in cases where a participant has been presented a stimuli and now needs to respond with the correct option or word-association.

Style 2 is useful when you wish to have a particpant rate something on a scale, like with a slider, but you also wish to use the 'embedded data' function.

When using the Rating Scale/Likert Widget you will get an additional row in your metrics - alongside the standard entry under the 'Question Key' & 'Response' columns - which represents the quantised version of your participants answer.
Quantised numbering starts at 1, corresponding to the first option you enter.

Configuration Settings:

Question Text

This text is presented directly above the rating scale/likert.


Rating

Type here the list of options you want to offer. Be sure each option is separated by commas.


Left End

Label for the left end of the scale/likert


Right End

Label for the right end of the scale/likert


Set Text Size

Allows you to manually select the text size of the rating options. Sizes offered are: 11px, 12px, and 14px.

Note: Auto gives a size of 14px, unless this will not fit onscreen, at which point it will reduce to 11px.


Key

This is the key name that identifies this response in your metrics data. We highly recommend you change this to a more meaningful name (see image example above) to make your data analysis easier.

Note: Keys should be unique across the questionnaire - no two responses should have the same key.


Write to Embedded Data

If checked, a participants response to this question will be written to the participant's embedded data, allowing you to retrieve and use it later in your experiment.

To retrieve this data later within your experiment you must use the same key as specified above.

Note: If you wish to overwrite the standard numbering with your own scoring use the embedded data key 'yourKeyNameHere-quantised'. Check out the Scripting in the Questionnaire Walkthrough for more information on this.


Allow Missing

If checked, the participant does not need to answer this question in order to progress.

Click to view a Tutorial of the Rating Scale/Likert Widget.

Click to view a Classic 'Big 5 Personality TIPI' Example which makes use of the Rating Scale/Likert Widget.

Ranking Widget


The Ranking Widget creates a list of sortable text objects from the options you provide. Participants can drop and drag the options to rearrange or sort them into any order.

The Ranking Widget is useful for cases where you wish to create a participant to rank a list of options into an order.

The final order the participant chooses will be written to the participants metrics.

Click Here To View A Live Demo of the Ranking Widget

Order these options:

  • Option1
  • Option2
  • Option3
  • Option4
  • Option5
Click Here To View the Metrics generated by a Ranking Widget
For each participant, your Ranking Widget will produce a unique row in your metrics spreadsheet corresponding to each option you provided to be ordered.
Each metric will state the final order the option was ranked in by the participant as shown in the example below:

Column Name Row Response Description
Question Key yourRankingWidgetKeyName-[Ranking(number)] This represents the key name you gave your Ranking Widget, with the participants final ranking order attached via the hyphen.

Note: The numbering for final ranking order starts at 1; this being the top most item in the list.
Response yourOptionNamesHere This is the actual response given by the participant for this ranking. It represents one of the options you provided for the participant to rank.

Configuration Settings:

Question Text

This text is presented directly above the dropdown box. This is often reserved for the question you wish the participant to answer in the preceeding dropdown box.


Options

Type here the list of options you want to offer. Be sure each option is separated by commas.


Top Label

Type here the name of the label to be presented at the top of your options list.


Bottom Label

Type here the name of the label to be presented at the bottom of your options list.


Key

This is the key name that identifies this response in your metrics data. We highly recommend you change this to a more meaningful name (see image example above) to make your data analysis easier.

Note: Keys should be unique across the questionnaire - no two responses should have the same key.


Write to Embedded Data

If checked, a participants response to this question will be written to the participant's embedded data, allowing you to retrieve and use it later in your experiment.

To retrieve this data later within your experiment you must use the same key as specified above.

Click to view a Tutorial of the Ranking Widget.

Script Widget


The Script Widget is an advanced-user widget which allows you to write your own code to do post-processing on your questionnaire data. The script widget will accept code written in Typescript and Javascript.

The Script Widget is useful for cases where you wish to create a scoring system - or overwrite the standard quantised scoring - from your participants questionnaire answers and then write these scores to your metrics spreadsheet.

In order to access a participants questionnaire answers within the script widget, you must make sure to have checked the 'write to embedded data' configuration option on every questionnaire widget you wish to interact with.

To learn more about how to use the Gorilla Script Widget check out the Scripting in the Questionnaire Walkthrough.

Also take a look at the Gorilla API to find out how to interact with Gorilla in your scripts.

Configuration Settings:

-- No Settings --

Click to view a Tutorial of the Script Widget.

Click to view a Classic 'Big 5 Personality TIPI' Example which makes use of the Script Widget.

Switch Button Widget


The Switch Button Widget adds a 'Switch' button to your questionnaire page, which allows the participant to switch to the corresponding Switch Node Task or Questionnaire in your experiment.

Note: The Switch Button Widget is a special Widget that must be used in conjunction with a Switch Node within your Experiment Tree in order to make use of its functionality.

  • You must include a Switch Widget in both Questionnaires or Tasks tethered to your Switch Node if you wish your participants to be able to switch freely between the questionnaires and/or tasks.
  • You must include a Switch Widget on every page of your Questionnaire that you wish your participant to be able to switch from.

The Switch Button Widget will only function when used in conjunction with a Switch Node within your Experiment Tree.
You can find out more about the Switch Node here.

The typical use case for using the Switch Widget and Switch Node is to provide information or instructions to a participant which can be available at any time while they are answering a questionnaire or completing a task. Check out the demos and examples below in the links at the bottom of this page to see this in action.

Click Here To view the Metric Columns generated by a Switch Widget & Switch Node
The Switch Widget, when used with a Switch Node in your experiment, adds 5 new data columns to your metrics spreadsheet:
Column Name Description
switch-nodekey-time-primary This is the total time (in ms) the participant spends on the primary task.
switch-nodekey-percentage-primary This is the time the participant spent on the primary task displayed as a percentage.
switch-nodekey-time-secondary This is the total time (in ms) the participant spends on the secondary task.
switch-nodekey-percentage-secondary This is the time the participant spent on the secondary task displayed as a percentage
switch-nodekey-switches This is a count of the total number of switches a participant made between the primary and secondary tasks.

Configuration Settings:

Button Label

You can change the text that appears on the switch button by adding a name to this field.

Click to view a Tutorial of the Switch Button Widget and Switch Node.

Click to view an Example which makes use of the Switch Button Widget and Switch Node.