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 20 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. Responses can be shown in the metrics as the date your respondent enters, or the years, months, and days that have passed from the date specified to the date they respond to the Questionnaire. This time passed can also be shown in months alone.

The Date Entry Widget is useful when you wish participants provide their date of birth or the date of an event.

The Date Entry Widget settings can also be used to collect months and years only, which is useful to collect GDPR compliant age data.

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

Please Enter your Date of Birth:

Configuration Settings:

Question Text

The text presented directly above the date entry dropdowns.


Retrieve as Age

If checked, a participant’s response to this question will be recorded as the time from this date to the time the participant completes the questionnaire in years, months and days. If asking for date of birth, this would be age.


Convert to Months

If checked, a participant’s response to this question will be recorded as the time from this date to the time the participant completes the questionnaire in months only. If asking for date of birth, this would be age.


Restrict Date

If checked, the ‘day’ dropdown will be removed, so participants will only be able to give the date in months and years. Because date of birth is considered Personally Identifying Information, this gives you a measure of age while remaining GDPR compliant.


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 with the addition of the type of data you wish to retrieve. This will be one of the following: '-day', ‘-month’ , ‘-year’, ‘-inmonths’.

i.e. MyDateWidgetKeyName-day will return the value stored as the response to the dropdown corresponding to day.

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.

Height Entry Widget


The Height Entry Widget adds a dropdown menu and numerical entry boxes, which allows participants to enter their height using either metric (meters and centimeters, m and cm) or imperial units (feet and inches, ft and ").

The participant is first offered the choice of their preferred units, imperial or metric, using the dropdown menu. Then based on their selection they will be offered two fields to enter their height:

  • Imperial: If the participant selected imperial units then two entry boxes for feet and inches will appear.
  • Metric: If the participant selected the metric option then two entry boxes for meters and centimeters will appear.

The Height Entry Widget is useful for cases where you wish the participant to enter their height using either of the standardised measurement options. This can be particularly useful if you wish to branch participants based on their answer.

Click Here To View An Image Example of the Height Entry Widget
Height Entry Widget Set Up:
Height Entry Widget Image Example
Two Height Entry Widgets viewed as a participant:

This example highlights the difference between the metric and imperial unit selection.

Height Entry Widget Image Example viewed as a participant
Click Here To View A Live Demo of the Height Entry Widget

Please enter your height:

Click Here To View the Metrics generated by a Height Entry Widget
For each participant, your Height Entry Widget will produce 3 unique rows in your metrics spreadsheet.
In the example below you can see data from two separate Height Entry Widgets. The first was answered in metric (note the word metric next to the '-unit' question key). Where as the second was answered in imperial (note the word imperial next to the '-unit' question key).

Column Name Row Response Description
Question Key yourHeightEntryWidgetKeyName-unit

This represents the key name you gave your Height Entry Widget, with the word 'unit' attached via the hyphen.

The data stored under this question key will represent the unit system chosen; either 'metric' or 'imperial'.

yourHeightEntryWidgetKeyName-first

This represents the key name you gave your Height Entry Widget, with the word 'first' attached via the hyphen.

The data stored under this question key will represent the value entered by the participant in the first (and largest) unit entry field.

yourHeightEntryWidgetKeyName-second

This represents the key name you gave your Height Entry Widget, with the word 'second' attached via the hyphen.

The data stored under this question key will represent the value entered by the participant in the second (and smallest) unit entry field.

Response metric or imperial

This is the response given by the participant which corresponds with the question key; 'keyname-unit'.
It represents the unit system the participant choose to enter their height in.

[number] (for first field)

This is the response given by the participant which corresponds with the question key; 'keyname-first'.
It represents the numerical value entered into the first field. This represents either meters or feet, depending upon which unit system, metric or imperial, was selected.

[number] (for second field)

This is the response given by the participant which corresponds with the question key; 'keyname-second'.
It represents the numerical value entered into the first field. This represents either centimeters or inches, depending upon which unit system, metric or imperial, was selected.

Click Here To View the Embedded data generated by a Height Entry Widget
Embedded Data and the Height Entry Widget:

The table below highlights the three unique keys used to retrieve embedded data from a Height Entry Widget.

As with all embedded data you can use the syntax $${myKeyNameHere} to retrieve and display the embedded data back to the participant

You can learn more about embedded data and the questionnaire builder here: How To: Questionnaires - Embedded data


In the example below you can see data from two separate Height Entry Widgets:

You can explore further how this was set up by viewing the demo.

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 Height Entry fields.


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 one of 3 suffixes: -unit , -first or -second.
These suffixes allow you to retrieve the unit choosen, the value entered in the first entry field, and the value entered in the second entry field respectively.

For example, if the participant choose metric from the dropdown and then entered 1 meter 70cm into the two fields, the embedded data retrieved would be as follows:

  1. keyName-unit = metric
  2. keyName-first = 1
  3. keyName-second = 70

For more information on using embedded data from the Height Entry Widget please view the Embedded Data section above.


Allow Missing

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

Click to view a Demo of the Height Entry Widget.

Weight Entry Widget


The Weight Entry Widget adds a dropdown menu and numerical entry boxes, which allows participants to enter their weight using either metric (kilograms, kg) or imperial units (stone and ounces, st. and lb.).

The participant is first offered the choice of their preferred units, imperial or metric, using the dropdown menu. Then based on their selection they will be offered two fields to enter their weight:

  • Imperial: If the participant selected imperial units then two entry boxes for stone and ounces will appear.
  • Metric: If the participant selected the metric option then one entry box for kilograms will appear.

The Weight Entry Widget is useful for cases where you wish the participant to enter their weight using either of the standardised measurement options. This can be particularly useful if you wish to branch participants based on their answer.

Click Here To View An Image Example of the Weight Entry Widget
Weight Entry Widget Set Up:
Weight Entry Widget Image Example
Two Weight Entry Widgets viewed as a participant:

This example highlights the difference between the metric and imperial unit selection.

Weight Entry Widget Image Example viewed as a participant
Click Here To View A Live Demo of the Weight Entry Widget

Please enter your weight:

Click Here To View the Metrics generated by a Weight Entry Widget
For each participant, your Weight Entry Widget will produce 3 unique rows in your metrics spreadsheet.
In the example below you can see data from two separate Weight Entry Widgets. The first was answered in metric (note the word metric next to the '-unit' question key). Where as the second was answered in imperial (note the word imperial next to the '-unit' question key).

Column Name Row Response Description
Question Key yourWeightEntryWidgetKeyName-unit

This represents the key name you gave your Weight Entry Widget, with the word 'unit' attached via the hyphen.

The data stored under this question key will represent the unit system chosen; either 'metric' or 'imperial'.

yourWeightEntryWidgetKeyName-first

This represents the key name you gave your Weight Entry Widget, with the word 'first' attached via the hyphen.

The data stored under this question key will represent the value entered by the participant in the first (and largest) unit entry field.

yourWeightEntryWidgetKeyName-second

This represents the key name you gave your Weight Entry Widget, with the word 'second' attached via the hyphen.

The data stored under this question key will represent the value entered by the participant in the second (and smallest) unit entry field.

Response metric or imperial

This is the response given by the participant which corresponds with the question key; 'keyname-unit'.
It represents the unit system the participant choose to enter their weight in.

[number] (for first field)

This is the response given by the participant which corresponds with the question key; 'keyname-first'.
It represents the numerical value entered into the first field. This represents either kilograms or stone, depending upon which unit system, metric or imperial, was selected.

[number] (for second field)

This is the response given by the participant which corresponds with the question key; 'keyname-second'.
It represents the numerical value entered into the first field. This represents either empty/blank or ounces, depending upon which unit system, metric or imperial, was selected.

Click Here To View the Embedded data generated by a Weight Entry Widget
Embedded Data and the Weight Entry Widget:

The table below highlights the three unique keys used to retrieve embedded data from a Weight Entry Widget.

As with all embedded data you can use the syntax $${myKeyNameHere} to retrieve and display the embedded data back to the participant.

You can learn more about embedded data and the questionnaire builder here: How To: Questionnaires - Embedded data


In the example below you can see data from two separate Weight Entry Widgets:

You can explore further how this was set up by viewing the demo.

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 Weight Entry fields.


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 one of 3 suffixes: -unit , -first or -second.
These suffixes allow you to retrieve the unit choosen, the value entered in the first entry field, and the value entered in the second entry field respectively.

For example, if the participant choose metric from the dropdown and then entered 8 stone 10 ounces into the two fields, the embedded data retrieved would be as follows:

  1. keyName-unit = metric
  2. keyName-first = 8
  3. keyName-second = 10

For more information on using embedded data from the Weight Entry Widget please view the Embedded Data section above.


Allow Missing

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

Click to view a Demo of the Weight 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.