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.

Click Here To View the Metrics generated by a Checklist Widget
For each participant, your Checklist Widget will produce a unique row in your metrics spreadsheet corresponding to each option your participant 'checked' in your checklist.

For example, if you have a checklist of 5 possible options and your participant checks two of these. The Checklist Widget will produce two additional rows in your metrics, one for each option checked.

In the image example below you will see that the original text of a checked checklist option will be shown in the 'Response' Column. Under the 'Question Key' column, notice that the Checklist item takes the form 'MyKeyName-OptionNumber'.

Column Name Row Response Description
Question Key yourChecklistWidgetKeyName-[Option(number)] This represents the Key name you gave your Checklist Widget, with the Option number attached via the hyphen.

Note: The numbering for Options starts at 1; this being the first item entered in your Options setting, when creating your list of checkbox items.
yourChecklistWidgetKeyName-other If you have selected to include an 'Other' option. This key name will represent that the 'Other' option was selected by your participant.

The key name match that given in your Checklist Widget Key setting, with the text 'other' attached via the hyphen.

Note: The response to this metric will either match the text you entered in the 'Prompt for Text Entry Option' setting else it will match the default text of 'Other (please specify)'.
yourChecklistWidgetKeyName-text If you have selected to include an 'Other' option. This key name will represent any text entered by the participant in the Text Entry field of the 'Other' option.

The key name match that given in your Checklist Widget Key setting, with the text 'text' attached via the hyphen.

Note: The response to this metric will match the text entered by the participant in the Text Entry field of the 'Other' option. If they did not enter any text, this field will be blank.
Response yourOptionNamesHere This is the actual value of the response given by the participant for this option. It represents the text entered as one of the options you provided for the participant to check.

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.


Minimum no. of Responses

Require a minimum number of responses. Please enter as a numerical digit i.e. 1, 2 etc.

If set, the participant will not be allowed to proceed unless they select at least the minimum number of responses.

Note: When setting the minimum number of responses your value must be lower than the total number of items entered into the Options setting of your Checklist Widget. Setting a number higher than the available options will prevent the participant from completing this question and advancing through your questionnaire.

Note: The 'Include Text Entry Option', if checked by a participant, does count towards their minimum number of responses.


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 with the addition of '-optionNumber'. Where optionNumber is a numerical integer referring to a specific item in your Options list.

i.e. MyChecklistWidgetKeyName-1 will return the value stored in the first item of your options list.

If the participant has checked this item. Then the value stored and returned will match the option text.
If the participant did not check this item the value stored and returned will be 0.

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 the stored embedded data later within your experiment you must use the same key as specified above with the addition of -# where # represents the ranking position you would like to retrieve.

For example, to retrieve the item currently stored in position 1 of a Ranking Widget use 'myKeyName-1' as the name for your embedded data. For position 2 use 'myKeyName-2'.

For more information on using embedded data from the Ranking Widget please view the Embedded Data section of the Ranking Widget Tutorial (linked below).

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.