Task Builder Zones


Overview


Welcome to the Task Builder Zones Tooling Reference Guide.

Here you can find out information on how and when to use a particular Task Builder Zone. There are 34 Zones available - browse the list of Zones in the menu on the left to find out more information about each one.

The most fundamental building blocks of Tasks are Zones. Each screen in a Task Builder display is made up of a number of zones.

Most Tasks consist of Content Zones, along with 'active' and 'passive' Response Zones which you can use to collect Reaction Time Data from your participants. There are also Feedback Zones, Control Zones, and Advanced Zones which can enrich your tasks and provide additional experimental control.

By using combinations of Zone types you can create complex tasks to measure your participants behaviour.

For all Zones you can:

  • Change Zone Content: Click on a Zone while in Edit Mode to change its contents.
  • Change Zone Type, Size & Position: Click on a Zone while in 'Edit Layout mode' of a screen.
  • Configure Zone Settings: Click the setting in Configuration Settings area.

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


Tooling Reference Guide Format:


For each Task Builder Zone listed you will find a description of the Zone, the Zone identifier icon and an image example. This will be followed by a configuration settings box (like the one below) which will list and explain all available configuration settings for the selected Zone.

Configuration Settings:

General Zone Settings Infomation

Each Zone will have a number of different setting options which appear as grey setting boxes like this: (setting)

Click on any (setting)'s box to bring up the setting's content menu. Here you input your setting content as well as choosing the content type (StaticSpreadsheetManipulationSpreadsheet-Manipulation). Just like you would with the Zone content itself.

In this guide, for quick reference, the options available for a particular setting will be written in the setting box. See the example below for demonstration.

You can find out more about Zones in the How To: Task Builder Guide


Go To Zone Configuration Settings example:

Go To
By default, a task will always advance to the next screen in a display.

When the screen is complete, advance to screen (text)

Setting (text): Type a screen name from the current display.

When the current screen is finished, Gorilla will advance to the named screen within your current display.

Click the Demo icon to view a Demo Task which demonstrates how you can use the selected Task Builder Zones.

Click the Example icon to view an example of a Sample Task which makes use of the selected Task Builder Zones.

Preview a task to experience the Zone in action. Inspect the task structure to see how a Zone is used.

Active Responses


Many Response Zones are considered Active Responses meaning that, when they are clicked or tapped on by a participant, their response is processed and recorded immediately.

When you use one or more of these Response Zones on a Screen, you will be presented with a single set of Configuration Settings under the heading Active Response.

These Configurations Setting will apply to all Response Zones on that screen.

Pro Tip!

The best way to set up Active Response Zones in 3 steps!

  1. First, Link each Response Zone to a separate spreadsheet column e.g.'button1', 'button2'. (Remember to set the Zone content type to be Spreadsheet).

  2. Now, add another spreadsheet column to your Task's Spreadsheet called 'Answer'; containing the correct answer for each trial.

  3. Finally, set Setting-1 of the 'Active Response' Configuration Settings (see below) be the same name as this new column i.e. 'Answer' (Content Type = Spreadsheet).

This way Gorilla will automatically score whether trials are answered correctly or incorrectly.

Configuration Settings:

Active Response


1) If a response's value matches (text), it represents the correct answer

Setting (text): Type a name of the correct answer (Static Content), or, correct answer column name (Spreadsheet Content).
                        

Default = none; No correct answer is set, all answers will be listed as 'incorrect' in your metrics.

If set answers matching this value will be marked as 'correct' in your metrics.


2) If (1 or 0), enable sudden death (first answer recorded only).
Note: Setting-1 must be set in order to use this setting.

Setting (1 or 0): Type 1 to turn setting on, Type 0 to turn setting off.
                        

Default = 0 (off); If the participant selects an incorrect answer the option is removed until the correct answer is chosen, at which point the participant will advance to the next screen.

If Sudden Death is set to 1 (on) the participant is only allowed a single response. Once the participant has responded the next screen is shown regardless of whether the response was correct or incorrect.


3) If (1 or 0), only score the first answer as correct
Note: Setting-2 must be set to 0 for this setting to apply.

Setting (1 or 0): Type 1 to turn setting on, Type 0 to turn setting off.
                        

Default = 0; the trial will be marked as 'correct', even if it was not the first response given.

If set to 1, trial will be marked as correct if and only if this was the first answer given.


4) Record a timeout as (text)
Note: This setting only applys if a Timelimit (screen) Zone is present.

Setting (text): set the text you wish to see recorded in the metrics when the timelimit for the screen is reached before a correct response is given.
                        

Default = none; if the timelimit is reached before a response is received, the 'response' column of your metrics will be blank.

If text is set, and the timelimit is reached before a response is received, the text is recorded under the 'response' column of your metrics.


Advanced Branching Settings


5) If correct, advance to screen (text)
Note: Setting-1 must be set in order to use this setting.

Setting (text): Type a screen name from the current display.
                        

Upon receiving a correct response, Gorilla will advance the task to the named screen within your current display.


6) If incorrect, advance to screen (text)
Note: Setting-1 must be set in order to use this setting.

Setting (text): Type a screen name from the current display.
                        

Upon receiving an incorrect response, Gorilla will advance the task to the named screen within your current display.


7) If timeout, advance to screen (text)
Note: Setting-1 must be set in order to use this setting.

Setting (text): Type a screen name from the current display.
                        

If there is a timelimit set and this expires before a response is received, Gorilla will advance the task to the named screen within your current display.


Embedded Data Settings


8) Store most recent answer as embedded data called (text)

Setting (text): Type a key-name for the embedded data.
                        

Default = none; No key is created, no embedded data is stored.

If set, this creates an embedded data key with the given name, this key will store the value of the most recent answer given.

You can then retrieve this value later using this key name and display it in text and rich text nodes, or use it in the tree to implement conditional branching.


9) Store correct answers as embedded data called (text)

Setting (text): Type a key-name for the embedded data.
                        

Default = none; No key is created, no embedded data is stored.

If set, this creates an embedded data key with the given name, this key will store the value of the 'count of all correct responses'.

You can then retrieve this value later using this key name and display it in text and rich text nodes, or use it in the tree to implement conditional branching based on performance.


10) Store incorrect answers as embedded data called (text)

Setting (text): Type a key-name for the embedded data.
                        

Default = none; No key is created, no embedded data is stored.

If set, this creates an embedded data key with the given name, this key will store the value of the 'count of all incorrect responses'.

You can then retrieve this value later using this key name and display it in text and rich text nodes, or use it in the tree to implement conditional branching based on performance.


11) Store total answer count as embedded data called (text)

Setting (text): Type a key-name for the embedded data.
                        

Default = none; No key is created, no embedded data is stored.

If set, this creates an embedded data key with the given name, this key will store the value of the 'count total of all responses (whether correct, incorrect or timed-out)'.

You can then retrieve this value later using this key name and display it in text and rich text nodes, or use it in the tree to implement conditional branching based on performance.


12) Store percentage correct answers as embedded data called (text)

Setting (text): Type a key-name for the embedded data.
                        

Default = none; No key is created, no embedded data is stored.

If set, this creates an embedded data key with the given name, this key will store the value of the 'percentage of all responses that were correct out of all total (correct, incorrect and timed-out) answers'. This value will be an integer between 0 and 100.

You can then retrieve this value later using this key name and display it in text and rich text nodes, or use it in the tree to implement conditional branching based on performance.

Passive Responses


Some input types, such as sliders and dropdown menus, do not have an obvious point at which the response is triggered - they can't be considered 'clicked' or 'pressed' in the same way as a button or keyboard key can.

Gorilla treats these input types as passive responses, meaning that their responses are collected when the screen is advanced.

While passive responses will always be collected when the screen advances, there are two common ways to implement them:

  • Use a Continue Button - this gives the participant the ability to enter their responses and then click a button to effectively 'submit' them when they are ready.
  • Use an Auto Advance - this gives the participant a fixed amount of time to enter their responses. The responses will be recorded in whatever state they were in when the auto advance triggered. N.B. This feature has now been deprecated and will no longer appear unless it has already been set. Use in its place the Timelimit (Screen) widget!

Text Zone


A Text Zone displays a single string of simple unformatted text. The text will auto-resize to fit the Zone's area and be centred within the Zone area.

Use the Text Zone to contain the unformatted text you wish to display. The Text Zone is typically used to display text stimuli.

Text Zone Icon:
Click Here To View An Image Example Of The Text Zone & Configuration Settings
In the example below, the Text Zone has been set-up to hide the text stimuli after 500 ms (Setting 1). Once 500ms has passed the text in the Text Zone will be hidden and no longer visible to the participant. The Participant will remain on this screen until they press the available 'Passive Response Zone' (the Continue Button).

Configuration Settings:

1) Hide after (number) ms

Setting (number): Type a time, as a number of milliseconds (ms), to represent the total duration for which the stimuli will be displayed. After this time has elapsed the stimuli will be hidden.

Default = no display time limit; The stimuli will be displayed the entire time the participant is viewing the screen containing this zone.

If set, the stimuli will be displayed until the set time has elapsed. At which point the stimuli will be hidden and no longer visible to the participant - Note: the participant will remain on the screen containing this zone until they advance to the next screen e.g. via a Passive Response Zone.

Click to view an Example of a Sample Task which makes use of the Text Zone.

Rich Text Zone


A Rich Text Zone displays formatted text. Text can be formatted using both Markdown and HTML. The text will auto-resize to fit the Zone's area and will be centred within the Zone area.

Use the Rich Text Zone to contain the formatted text you wish to display. The Rich Text Zone is typically used to display formatted instructions or introduction text.

Rich Text Zone Icon:
Click Here To View An Image Example Of The Rich Text Zone & Configuration Settings
In the example below, the Rich Text Zone has been set-up to hide the text stimuli after 500 ms (Setting 1). Once 500ms has passed the text in the Rich Text Zone will be hidden and no longer visible to the participant. The Participant will remain on this screen until they press the available 'Passive Response Zone' (the Continue Button).

Configuration Settings:

1) Hide after (number) ms

Setting (number): Type a time, as a number of milliseconds (ms), to represent the total duration for which the stimuli will be displayed. After this time has elapsed the stimuli will be hidden.

Default = no display time limit; The stimuli will be displayed the entire time the participant is viewing the screen containing this zone.

If set, the stimuli will be displayed until the set time has elapsed. At which point the stimuli will be hidden and no longer visible to the participant - Note: the participant will remain on the screen containing this zone until they advance to the next screen e.g. via a Passive Response Zone.

Click to view a Demo of the Rich Text Zone.

Click to view a Classic Semantic Priming Example of a Sample Task which makes use of the Rich Text Zone.

Image Zone


The Image Zone allows you to display a single uploaded image on your screen.
You must first upload the image in the Stimuli Tab of the Task Builder. Then type the full stimuli name (including file type) within the Image Zone or relevant spreadsheet column.

The image will auto-resize to fit the Zone's area and be centred within the Zone area. This means the image will be displayed as large as possible within the Zone's area, but will not be stretched or enlarged above it's natural, uploaded, size.

Supported Image types: .png, .jpg, .jpeg, and .gif including repeating GIFs. Non-repeating GIFs are not recommended.*

Use the Image Zone to contain the Image you wish to display. The Image Zone is typically used to present image stimuli.

Image Zone Icon:
Click Here To View An Image Example Of The Image Zone & Configuration Settings
In the example below, the Image Zone has been set-up to hide the image stimuli after 200 ms (Setting 1). Once 200ms has passed the text in the Image Zone will be hidden and no longer visible to the participant. The Participant will remain on this screen until they press the available 'Passive Response Zone' (the Continue Button).

Configuration Settings:

1) Hide after (number) ms

Setting (number): Type a time, as a number of milliseconds (ms), to represent the total duration for which the stimuli will be displayed. After this time has elapsed the stimuli will be hidden.

Default = no display time limit; The stimuli will be displayed the entire time the participant is viewing the screen containing this zone.

If set, the stimuli will be displayed until the set time has elapsed. At which point the stimuli will be hidden and no longer visible to the participant - Note: the participant will remain on the screen containing this zone until they advance to the next screen e.g. via a Passive Response Zone.

Click to view an Example of a Sample Task which makes use of the Image Zone.


* More Information about GIF's:

Gorilla pre-loads task material in advance of participants seeing it, so that when participants reach a new screen all page elements are ready to be displayed.

In the case of non-repeating GIFs there is no way to tell a GIF when to 'start' playing.
A non-repeating GIF will play through once and then stop on the last frame. As such by the time a participant reaches the GIF it may already have played through once and be sitting static on the last frame of the GIF.
To avoid this we recommend:

  1. Use Repeating GIFs - this way the participant will definitely see the whole GIF.
  2. Turn your GIF into a Video and use a Video/Embedded YouTube/Embedded Vimeo Zone instead.

Audio Zone


The Audio Zone allows you to add a single uploaded audio (sound) file to your screen.
You must first upload the audio file in the Stimuli Tab of the Task Builder. Then type the full stimuli name (including file type) within the Audio Zone or relevant spreadsheet column.

Supported audio file types: .mp3, .ogg.

We recommend using the .mp3 format for audio files. This is the most widely supported audio file format and the de facto standard for audio on the web.
* Please Note: .wav files are not widely supported for online use and we highly recommend you convert all .wav files to mp3 before uploading them as stimuli, in order to avoid issues and variation in browser playback performance. Upon uploading a .wav file a warning message will appear.

Use the Audio Zone to contain the audio media you wish to present. The Audio Zone is typically used to present audio stimuli.

If you are presented with a ‘Media not found’ message when previewing your task:

  1. Check that the Audio file has been uploaded.
  2. Check that there are no spelling errors in the file name within the Zone. This is often due to a space at the beginning of the file name.
  3. Review the Media Error Message troubleshooting guide for further help.
Audio Zone Icon:

Click Here To View An Image Example Of The Audio Zone & Configuration Settings
In the example below, the Audio Zone has been set-up to be started manually by the participant (Setting1) and be played a total of 3 times (Setting2). This Audio Zone is not set to auto-advance (Setting3) and so a continue button (Response Zone) is needed to allow the participant to move the screen on manually.
Click Here To view the Metric Columns & Rows generated by an Audio Zone
The Audio Zone produces specific metrics in 4 columns within your Data-Spreadsheet.
If you opt to allow participants to start playing the media manually (or be able to repeat playing the media) you will also produce an additional row in your Data Spreadsheet for the time when the participant started the audio.

You can view an example of the metrics produced by the Audio Zone in the image below:
image example of Audio Zone metrics
Column Name Row Entry Description
Zone Type content_audio This is the Zone 'Type' identifier for the Audio Zone.
Reaction Time [Number] This is the reaction time in milliseconds (ms).

1. If the Audio Zone has been set up to play automatically and then also advance automatically this number represents the time, in ms, at which the zone finished playing and the screen advanced.
2. If the Audio Zone has been set up to be started manually (or the repeat functionality has been enabled) then this number will represent the reaction-time, in ms, at which the participant pressed the 'Play' media button. (see 'Response' column below)
Response [Blank] or "AUDIO STARTED" This indicates if the participant has pressed a 'Play' media button.

1. If the Audio Zone has been set up to be started manually (or the repeat functionality has been enabled) then you will gain an additional row entry with the response entry: 'AUDIO STARTED'. This indicates the reaction time (see above) at which the participant pressed the 'Play' media button.
2. This column will appear blank/empty otherwise.
Attempt [Number] This indicates the number of times the participant has pressed the 'Play' media button.

1. If the Audio Zone has been set up to be started manually (or the repeat functionality has been enabled) then this is the number of times the participant has opted to play the media.
2. This column will appear blank/empty otherwise.

Configuration Settings:

1) If (1 or 0) allow participant to start media manually

Setting (1 or 0): Type 1 to turn setting on, Type 0 to turn setting off.

Default = 1 (on); a play button will be shown allowing the participant to manually start the media playback.

If set to 0 (off) the audio will play automatically when the participant arrives at the screen of the Audio Zone.

Autoplay of audio in some browsers is no longer permitted! To learn more about these changes and how they may affect you, review this article: Autoplay Changes


2) Media can be played up to (number) times

Setting (number): Type the number of times you wish the media to be re-playable.

Default = 1; the audio will play once.
Note: Setting-1 must be turned on (1) in order to use this setting.

Set any number (numerical value) to limit the participant to this many plays.

If they are allowed to replay the media, a Replay button will be shown once the media has finished playing fully.

If set to 0, the media will be infinitely replayable, i.e. there is no limit to the number of times a participant can repeat this media.


3) If (1 or 0) advance when media is finished

Setting (1 or 0): Type 1 to turn setting on, Type 0 to turn setting off.

If set to 1 (on), the screen will automatically advance once the media has finished playing.

Click to view an Example of a Sample Project which makes use of the Audio Zone.

Video Zone


The Video Zone allows you to add a single uploaded video file to your screen.
You must first upload the video file in the Stimuli Tab of the Task Builder. Then type the full stimuli name (including file type) within the Video Zone or relevant spreadsheet column.

.mp4 file types are supported.

Use the Video Zone to contain the video media you wish to present. The Video Zone is typically used to present short video stimuli.

If you are presented with a ‘Media not found’ message when previewing your task:

  1. Check that the Video file has been uploaded.
  2. Check that the file type is .mp4
  3. Check that there are no spelling errors in the file name within the Zone. This is often due to a space at the beginning of the file name.

If you are presented with a ‘MEDIA_ERR_DECODE’ message, this suggests that your video file is corrupted. This means that the video may stop at any point during your task. If this is the case, we recommend using a different video file.

Video Zone Icon:

Click Here To View An Image Example Of The Video Zone & Configuration Settings
In the example below, the Video Zone has been set-up to be started manually by the participant (Setting1) and will play once (Setting2). When the video has finished playing it will auto-advance (Setting3) to the next screen.
Click Here To view the Metric Columns & Rows generated by an Video Zone
The Video Zone produces specific metrics in 4 columns within your Data-Spreadsheet.
If you opt to allow participants to start playing the media manually (or be able to repeat playing the media) you will also produce an additional row in your Data Spreadsheet for the time when the participant started the video.

You can view an example of the metrics produced by the Video Zone in the image below:
image example of Video Zone metrics
Column Name Row Entry Description
Zone Type content_video This is the Zone 'Type' identifier for the Video Zone.
Reaction Time [Number] This is the reaction time in milliseconds (ms).

1. If the Video Zone has been set up to play automatically and then also advance automatically this number represents the time, in ms, at which the zone finished playing and the screen advanced.
2. If the Video Zone has been set up to be started manually (and if the repeat functionality has been enabled) then this number will represent the reaction-time, in ms, at which the participant pressed to play the video media. (see 'Response' column below)
Response [Blank] or "VIDEO STARTED" This indicates if the participant has pressed to play the media.

1. If the Video Zone has been set up to be started manually (and if the repeat functionality has been enabled) then you will gain an additional row entry with the response entry: 'VIDEO STARTED'. This indicates the reaction time (see above) at which the participant pressed to play the video media.
2. This column will appear blank/empty otherwise.
Attempt [Number] This indicates the number of times the participant has pressed to play the media.

1. If the Video Zone has been set up to be started manually (and if the repeat functionality has been enabled) then this is the number of times the participant has opted to play the media.
2. This column will appear blank/empty otherwise.

Configuration Settings:

1) If (1 or 0) allow participant to start media manually

Setting (1 or 0): Type 1 to turn setting on, Type 0 to turn setting off.

Default = 1 (on); the participant can manually start the media playback by clicking on the video.

If set to 0 (off); the video will play automatically when the participant arrives at the screen of the Video Zone.

Autoplay of video in some browsers is no longer permitted! To learn more about these changes and how they may affect you, review this article: Autoplay Changes


2) Media can be played up to (number) times

Setting (number): Type the number of times you wish the media to be re-playable.

Default = 1; the video will play once.
Note: Setting-1 must be turned on in order to use this setting.

Set any number (numerical value) to limit the participant to this many plays.

If they are allowed to replay the media, the media can be replayed by clicking on the video once it has finished playing fully.

If set to 0, the media will be infinitely replayable, i.e. there is no limit to the number of times a participant can repeat this media.


3) If (1 or 0) advance when media is finished

Setting (1 or 0): Type 1 to turn setting on, Type 0 to turn setting off.

Default = 0 (off); the screen must be advanced manually by the participant via a Response Zone.

If set to 1 (on), the screen will automatically advance once the media has finished playing.


4) if (1 or 0) mute audio track in video

Setting (1 or 0): Type 1 to turn setting on, Type 0 to turn setting off.

Default = 0 (off); the video will not play muted.

If set to 1 (on), the video will play muted.

Note: Autoplay settings on some browsers will prevent videos with sound from playing automatically. If the video has no sound, some browsers will fail to recognise this and prevent the video from playing. If the video is explicitly muted, browsers will be less likely to prevent autoplay.

Click to view an Example of a Sample Project which makes use of the Video Zone.

Embedded YouTube Zone


The Embedded YouTube Zone allows you to present a single YouTube video on your screen.
You must first copy the link of the YouTube video you wish to Embed.
Then paste link into the Embedded YouTube Zone or relevant spreadsheet column.

For the link you can use any of the following:

  • The full URL of the YouTube video (https://youtube.com/watch?v=ABCDEF)
  • The Share link (https://youtu.be/ABCDEF)
  • Just the video ID (ABCDEF)

Use the Embedded YouTube Zone to contain the video media you wish to present. The Embedded YouTube Zone is typically used to present short YouTube video stimuli.

Note: Be sure that any youTube video you are linking with your Embedded youTube Zone is listed on youTube as Public or Unlisted. While videos listed as Private may run for you when you preview your Task they will not work for your participants.

Caution - Incompatible with some Mobile and Tablet Devices

If you are allowing participants to undertake your experiment on mobile phones or tablets. We do not recommend using the Embedded YouTube Zone. Instead use the Gorilla Video Zone to host your videos. This is because the functionality provided by youTube to embed their hosted videos is not compatible and will not work with all mobile and tablet devices.

If you wish to take make the switch to using the Gorilla Video Zone you will need to follow these steps:
  1. Download your videos from youTube or locate your original video files.
  2. Upload your videos to your Gorilla Task under your Task's Stimuli Tab.
  3. In your Task Structure change the type of all your Embedded youTube Zones to be Video Zones.
  4. In your Video Zones or Task Spreadsheet: Replace all references to your youTube videos with the videos full file name found in your Task's Stimuli Tab.

If you are not planning to allow participants on mobile or tablets. We strongly recommend using the limit device type setting in your Experiment Requirements to ensure only participants on desktops or laptops can take part in your experiment.

Important Note on Autoplay:

Since the changes made to Autoplay which came to the web in March 2018, most browsers will not allow autoplay of any media (video or audio). This led to problems with media playback which prevented some participants from viewing any autoplay video content and advancing within tasks.

To ensure participants can complete your Task, without experiencing any autoplay problems, we've added an autoplay safety feature. This means embedded youTube videos will now automatically revert to the manual play method in cases where they would otherwise have been blocked by autoplay.

How does the autoplay safety feature work?
If you have set up your embedded youTube videos to play automatically but autoplay is blocked locally by the participants browser. After 5 seconds if Gorilla detects that your embedded youTube video has not begun to autoplay the standard youtube manual play button will appear in the center of the youTube video. The video will then begin to play as soon as and the participant interacts with it.
All other functionality of the embedded youTube zone (such as repetition or auto-advance) should then work as expected.

You can read more about the changes to auto-play and the consequences to online experimentation in our article: Changes to AutoPlay functionality in the web.

Embedded YouTube Zone Icon:

Configuration Settings:

1) If (1 or 0) allow participant to start media manually

Setting (1 or 0): Type 1 to turn setting on, Type 0 to turn setting off.

Default = 0 (off); the video will play automatically when the participant arrives at the screen of the Embedded YouTube Zone.

If set to 1 (on) the participant can manually start the media playback by clicking on the video.

Note: If participant browser blocks autoplay then after 5 seconds the video will revert to manual play (1) method automatically.

For more details read the section 'Important Note on Autoplay' above.


2) Media can be played up to (number) times

Setting (number): Type the number of times you wish the media to be re-playable.

Default = 1; the video will play once.
Note: Setting-1 must be turned on in order to use this setting.

Set any number (numerical value) to limit the participant to this many plays.

If they are allowed to replay the media, the media can be replayed by clicking on the video once it has finished playing fully.

If set to 0, the media will be infinitely replayable, i.e. there is no limit to the number of times a participant can repeat this media.


3) If (1 or 0) advance when media is finished

Setting (1 or 0): Type 1 to turn setting on, Type 0 to turn setting off.

Default = 0 (off); the screen must be advanced manually by the participant via a Response Zone.

If set to 1 (on), the screen will automatically advance once the media has finished playing.

Click to view an Example of a Sample Task which makes use of the Embedded YouTube Zone.

Embedded Vimeo Zone


The Embedded Vimeo Zone allows you to present a single Vimeo video on your screen.
You must first copy the link of the Vimeo video you wish to Embed.
Then paste link into the Embedded Vimeo Zone or relevant spreadsheet column.

For the link you can use any of the following:

  • The full URL of the Vimeo video (https://vimeo.com/ABCDEF)
  • Just the video ID (ABCDEF)

Use the Embedded Vimeo Zone to contain the video media you wish to present. The Embedded Vimeo Zone is typically used to present short Vimeo video stimuli.

Embedded Vimeo Zone Icon:

Configuration Settings:

-- No Settings --

Continue Button Zone


6

The Continue Button Zone adds a simple 'continue' button to your screen. For a participant, clicking the button will allow them to progress to the next screen. The reaction time is recorded in the metrics at this point.

The Continue Button Zone label defaults to 'Next'. You can change the default by editing the Zone content. The button will appear as centred in the Zone's area and will be resized to fit the label.

Use the Continue Button Zone to allow particpants to manually advance to the next screen. The Continue Button Zone is typically used on instructions and debrief material screens - where you wish the participant to advance to the next screen in their own time.

Continue Button Zone Icon:

Configuration Settings:

The Continue Button Zone is an Passive Response Zone. Find out more about Passive Responses here.


-- No Settings --

Click to view an Example of a Sample Project which makes use of the Continue Button Zone.

Response Button (Text) Zone


The Response Button (Text) Zone adds a simple clickable button containing text to your screen.

  • Edit the Zone content to set the text you wish the button to contain.
  • Edit the 'Active Response' Configuration Settings to set how the button(s) will function when a participant clicks on it.

The button's size and placement will match the Zone area you set for it. Any text entered into the Response Button (Text) Zone will be resized and centred to ensure it fits within the button area.

Use the Response Button (Text) Zone when you want particpants to select a correct answer via a set of text buttons. The Response Button (Text) Zone is typically used to ask participants to 'select' a response, or 'correct answer', from a set of other button options.

Response Button (Text) Zone Icon:

Click Here To View An Image Example Of The Response Button (Text) Zone & Configuration Settings
In the example below, the Response Button (Text) Zone, has been set up so that the correct answer is set, as static content, to 'Yes' (Setting 1). Sudden Death has been turned on (Setting 2) which means once the participant has clicked on either button their answer is recorded and they will advance to the next screen

Configuration Settings:

The Response Button (Text) Zone is an Active Response Zone. Find out more about active responses and their corresponding 'Active Response' Configuration Setting Options here.

Click Here To View The Active Response Configuration Settings

Active Response


1) If a response's value matches (text), it represents the correct answer

Setting (text): Type a name of the correct answer (Static Content), or, correct answer column name (Spreadsheet Content).
                                

Default = none; No correct answer is set, all answers will be listed as 'incorrect' in your metrics.

If set answers matching this value will be marked as 'correct' in your metrics.


2) If (1 or 0), enable sudden death (first answer recorded only).
Note: Setting-1 must be set in order to use this setting.

Setting (1 or 0): Type 1 to turn setting on, Type 0 to turn setting off.
                                

Default = 0 (off); If the participant selects an incorrect answer the option is removed until the correct answer is chosen, at which point the participant will advance to the next screen.

If Sudden Death is set to 1 (on) the participant is only allowed a single response. Once the participant has responded the next screen is shown regardless of whether the response was correct or incorrect.


3) If (1 or 0), only score the first answer as correct
Note: Setting-2 must be set to 0 for this setting to apply.

Setting (1 or 0): Type 1 to turn setting on, Type 0 to turn setting off.
                                

Default = 0; the trial will be marked as 'correct', even if it was not the first response given.

If set to 1, trial will be marked as correct if and only if this was the first answer given.


4) Record a timeout as (text)
Note: This setting only applys if a Timelimit (screen) Zone is present.

Setting (text): set the text you wish to see recorded in the metrics when the timelimit for the screen is reached before a correct response is given.
                                

Default = none; if the timelimit is reached before a response is received, the 'response' column of your metrics will be blank.

If text is set, and the timelimit is reached before a response is received, the text is recorded under the 'response' column of your metrics.


Advanced Branching Settings


5) If correct, advance to screen (text)
Note: Setting-1 must be set in order to use this setting.

Setting (text): Type a screen name from the current display.
                                

Upon receiving a correct response, Gorilla will advance the task to the named screen within your current display.


6) If incorrect, advance to screen (text)
Note: Setting-1 must be set in order to use this setting.

Setting (text): Type a screen name from the current display.
                                

Upon receiving an incorrect response, Gorilla will advance the task to the named screen within your current display.


7) If timeout, advance to screen (text)
Note: Setting-1 must be set in order to use this setting.

Setting (text): Type a screen name from the current display.
                                

If there is a timelimit set and this expires before a response is received, Gorilla will advance the task to the named screen within your current display.


Embedded Data Settings


8) Store most recent answer as embedded data called (text)

Setting (text): Type a key-name for the embedded data.
                                

Default = none; No key is created, no embedded data is stored.

If set, this creates an embedded data key with the given name, this key will store the value of the most recent answer given.

You can then retrieve this value later using this key name and display it in text and rich text nodes, or use it in the tree to implement conditional branching.


9) Store correct answers as embedded data called (text)

Setting (text): Type a key-name for the embedded data.
                                

Default = none; No key is created, no embedded data is stored.

If set, this creates an embedded data key with the given name, this key will store the value of the 'count of all correct responses'.

You can then retrieve this value later using this key name and display it in text and rich text nodes, or use it in the tree to implement conditional branching based on performance.


10) Store incorrect answers as embedded data called (text)

Setting (text): Type a key-name for the embedded data.
                                

Default = none; No key is created, no embedded data is stored.

If set, this creates an embedded data key with the given name, this key will store the value of the 'count of all incorrect responses'.

You can then retrieve this value later using this key name and display it in text and rich text nodes, or use it in the tree to implement conditional branching based on performance.


11) Store total answer count as embedded data called (text)

Setting (text): Type a key-name for the embedded data.
                                

Default = none; No key is created, no embedded data is stored.

If set, this creates an embedded data key with the given name, this key will store the value of the 'count total of all responses (whether correct, incorrect or timed-out)'.

You can then retrieve this value later using this key name and display it in text and rich text nodes, or use it in the tree to implement conditional branching based on performance.


12) Store percentage correct answers as embedded data called (text)

Setting (text): Type a key-name for the embedded data.
                                

Default = none; No key is created, no embedded data is stored.

If set, this creates an embedded data key with the given name, this key will store the value of the 'percentage of all responses that were correct out of all total (correct, incorrect and timed-out) answers'. This value will be an integer between 0 and 100.

You can then retrieve this value later using this key name and display it in text and rich text nodes, or use it in the tree to implement conditional branching based on performance.

-- No Additional Settings --

Click to view an Example of a Sample Project which makes use of the Response Button (Text) Zone.

Response Button Paragraph (Text) Zone


The Response Button Paragraph (Text) Zone adds a simple clickable button containing a text paragraph to your screen.

  • Edit the Zone content to set the text you wish the button to contain.
  • Edit the 'Active Response' Configuration Settings to set how the button(s) will function when a participant clicks on it.

The button's size and placement will match the Zone area you set for it. Any text entered into the Response Button (Text) Zone will be resized and centred to ensure it fits within the button area.

Use the Response Button Paragraph (Text) Zone when you want particpants to select a correct answer via a set of text buttons which contain a large amount of text. The Response Button Paragraph (Text) Zone is typically used to ask participants to 'select' a response, or 'correct answer', from a set of other similar button options.

Response Button Paragraph (Text) Zone Icon:

Click Here To View An Image Example Of The Response Button Paragraph (Text) Zone & Configuration Settings
In the example below, the Response Button Paragraph (Text) Zones, has been set up so that responses are recorded as 'ParagraphA' and 'ParagraphB' respectively (Setting-1). The correct answer is set, as static content, to 'ParagraphA' (Setting 1: CorrectAnswer). Sudden Death has been turned on (Setting 2) which means once the participant has clicked on either button their answer is recorded and they will advance to the next screen

Configuration Settings:

The Response Button Paragraph (Text) Zone is an Active Response Zone. Find out more about active responses and their corresponding 'Active Response' Configuration Setting Options here.

Click Here To View The Active Response Configuration Settings

Active Response


1) If a response's value matches (text), it represents the correct answer

Setting (text): Type a name of the correct answer (Static Content), or, correct answer column name (Spreadsheet Content).
                                

Default = none; No correct answer is set, all answers will be listed as 'incorrect' in your metrics.

If set answers matching this value will be marked as 'correct' in your metrics.


2) If (1 or 0), enable sudden death (first answer recorded only).
Note: Setting-1 must be set in order to use this setting.

Setting (1 or 0): Type 1 to turn setting on, Type 0 to turn setting off.
                                

Default = 0 (off); If the participant selects an incorrect answer the option is removed until the correct answer is chosen, at which point the participant will advance to the next screen.

If Sudden Death is set to 1 (on) the participant is only allowed a single response. Once the participant has responded the next screen is shown regardless of whether the response was correct or incorrect.


3) If (1 or 0), only score the first answer as correct
Note: Setting-2 must be set to 0 for this setting to apply.

Setting (1 or 0): Type 1 to turn setting on, Type 0 to turn setting off.
                                

Default = 0; the trial will be marked as 'correct', even if it was not the first response given.

If set to 1, trial will be marked as correct if and only if this was the first answer given.


4) Record a timeout as (text)
Note: This setting only applys if a Timelimit (screen) Zone is present.

Setting (text): set the text you wish to see recorded in the metrics when the timelimit for the screen is reached before a correct response is given.
                                

Default = none; if the timelimit is reached before a response is received, the 'response' column of your metrics will be blank.

If text is set, and the timelimit is reached before a response is received, the text is recorded under the 'response' column of your metrics.


Advanced Branching Settings


5) If correct, advance to screen (text)
Note: Setting-1 must be set in order to use this setting.

Setting (text): Type a screen name from the current display.
                                

Upon receiving a correct response, Gorilla will advance the task to the named screen within your current display.


6) If incorrect, advance to screen (text)
Note: Setting-1 must be set in order to use this setting.

Setting (text): Type a screen name from the current display.
                                

Upon receiving an incorrect response, Gorilla will advance the task to the named screen within your current display.


7) If timeout, advance to screen (text)
Note: Setting-1 must be set in order to use this setting.

Setting (text): Type a screen name from the current display.
                                

If there is a timelimit set and this expires before a response is received, Gorilla will advance the task to the named screen within your current display.


Embedded Data Settings


8) Store most recent answer as embedded data called (text)

Setting (text): Type a key-name for the embedded data.
                                

Default = none; No key is created, no embedded data is stored.

If set, this creates an embedded data key with the given name, this key will store the value of the most recent answer given.

You can then retrieve this value later using this key name and display it in text and rich text nodes, or use it in the tree to implement conditional branching.


9) Store correct answers as embedded data called (text)

Setting (text): Type a key-name for the embedded data.
                                

Default = none; No key is created, no embedded data is stored.

If set, this creates an embedded data key with the given name, this key will store the value of the 'count of all correct responses'.

You can then retrieve this value later using this key name and display it in text and rich text nodes, or use it in the tree to implement conditional branching based on performance.


10) Store incorrect answers as embedded data called (text)

Setting (text): Type a key-name for the embedded data.
                                

Default = none; No key is created, no embedded data is stored.

If set, this creates an embedded data key with the given name, this key will store the value of the 'count of all incorrect responses'.

You can then retrieve this value later using this key name and display it in text and rich text nodes, or use it in the tree to implement conditional branching based on performance.


11) Store total answer count as embedded data called (text)

Setting (text): Type a key-name for the embedded data.
                                

Default = none; No key is created, no embedded data is stored.

If set, this creates an embedded data key with the given name, this key will store the value of the 'count total of all responses (whether correct, incorrect or timed-out)'.

You can then retrieve this value later using this key name and display it in text and rich text nodes, or use it in the tree to implement conditional branching based on performance.


12) Store percentage correct answers as embedded data called (text)

Setting (text): Type a key-name for the embedded data.
                                

Default = none; No key is created, no embedded data is stored.

If set, this creates an embedded data key with the given name, this key will store the value of the 'percentage of all responses that were correct out of all total (correct, incorrect and timed-out) answers'. This value will be an integer between 0 and 100.

You can then retrieve this value later using this key name and display it in text and rich text nodes, or use it in the tree to implement conditional branching based on performance.

1) When clicked, record response as (text) (Mandatory)

Setting (text): Type the name-label you wish to be assigned as the recorded response identifier.

Default = none; the reaction time response will be recorded but there will be no response identifier recorded.

If set this name-label is what will be recorded in the metrics, if this button is selected as a response by a participant. This is also the label used for the purpose of determining whether the clicked button represents a correct or incorrect answer (setting-1 of Correct Answer Settings).

Click to view an Example of a Sample Project which makes use of the Response Button Paragraph (Text) Zone.

Response Button Paragraph (Rich Text) Zone


The Response Button Paragraph (Rich Text) Zone adds a simple clickable button containing a rich text paragraph to your screen. This Zone is identical to the Response Button Paragraph (Text) Zone except that the text can be formatted using Markdown and HTML.

  • Edit the Zone content to set the text you wish the button to contain.
  • Edit the 'Active Response' Configuration Settings to set how the button(s) will function when a participant clicks on it.

The button's size and placement will match the Zone area you set for it. Any text entered into the Response Button (Text) Zone will be resized and centred to ensure it fits within the button area*.
*This is true unless these defaults are overwritten by Markdown or HTML used within the Zone content.

Use the Response Button Paragraph (Rich Text) Zone when you want particpants to select a correct answer via a set of text buttons which contain a large amount of formatted text. The Response Button Paragraph (Rich Text) Zone is typically used to ask participants to 'select' a response, or 'correct answer', from a set of other similar button options.

Response Button Paragraph (Rich Text) Zone Icon:

Click Here To View An Image Example Of The Response Button Paragraph (Rich Text) Zone & Configuration Settings
In the example below, the Response Button Paragraph (Rich Text) Zones, has been set up so that responses are recorded as 'ParagraphA' and 'ParagraphB' respectively (Setting-1). The correct answer is set, as static content, to 'ParagraphA' (Setting 1: CorrectAnswer). Sudden Death has been turned on (Setting 2) which means once the participant has clicked on either button their answer is recorded and they will advance to the next screen

Configuration Settings:

The Response Button Paragraph (Rich Text) Zone is an Active Response Zone. Find out more about active responses and their corresponding 'Active Response' Configuration Setting Options here.

Click Here To View The Active Response Configuration Settings

Active Response


1) If a response's value matches (text), it represents the correct answer

Setting (text): Type a name of the correct answer (Static Content), or, correct answer column name (Spreadsheet Content).
                                

Default = none; No correct answer is set, all answers will be listed as 'incorrect' in your metrics.

If set answers matching this value will be marked as 'correct' in your metrics.


2) If (1 or 0), enable sudden death (first answer recorded only).
Note: Setting-1 must be set in order to use this setting.

Setting (1 or 0): Type 1 to turn setting on, Type 0 to turn setting off.
                                

Default = 0 (off); If the participant selects an incorrect answer the option is removed until the correct answer is chosen, at which point the participant will advance to the next screen.

If Sudden Death is set to 1 (on) the participant is only allowed a single response. Once the participant has responded the next screen is shown regardless of whether the response was correct or incorrect.


3) If (1 or 0), only score the first answer as correct
Note: Setting-2 must be set to 0 for this setting to apply.

Setting (1 or 0): Type 1 to turn setting on, Type 0 to turn setting off.
                                

Default = 0; the trial will be marked as 'correct', even if it was not the first response given.

If set to 1, trial will be marked as correct if and only if this was the first answer given.


4) Record a timeout as (text)
Note: This setting only applys if a Timelimit (screen) Zone is present.

Setting (text): set the text you wish to see recorded in the metrics when the timelimit for the screen is reached before a correct response is given.
                                

Default = none; if the timelimit is reached before a response is received, the 'response' column of your metrics will be blank.

If text is set, and the timelimit is reached before a response is received, the text is recorded under the 'response' column of your metrics.


Advanced Branching Settings


5) If correct, advance to screen (text)
Note: Setting-1 must be set in order to use this setting.

Setting (text): Type a screen name from the current display.
                                

Upon receiving a correct response, Gorilla will advance the task to the named screen within your current display.


6) If incorrect, advance to screen (text)
Note: Setting-1 must be set in order to use this setting.

Setting (text): Type a screen name from the current display.
                                

Upon receiving an incorrect response, Gorilla will advance the task to the named screen within your current display.


7) If timeout, advance to screen (text)
Note: Setting-1 must be set in order to use this setting.

Setting (text): Type a screen name from the current display.
                                

If there is a timelimit set and this expires before a response is received, Gorilla will advance the task to the named screen within your current display.


Embedded Data Settings


8) Store most recent answer as embedded data called (text)

Setting (text): Type a key-name for the embedded data.
                                

Default = none; No key is created, no embedded data is stored.

If set, this creates an embedded data key with the given name, this key will store the value of the most recent answer given.

You can then retrieve this value later using this key name and display it in text and rich text nodes, or use it in the tree to implement conditional branching.


9) Store correct answers as embedded data called (text)

Setting (text): Type a key-name for the embedded data.
                                

Default = none; No key is created, no embedded data is stored.

If set, this creates an embedded data key with the given name, this key will store the value of the 'count of all correct responses'.

You can then retrieve this value later using this key name and display it in text and rich text nodes, or use it in the tree to implement conditional branching based on performance.


10) Store incorrect answers as embedded data called (text)

Setting (text): Type a key-name for the embedded data.
                                

Default = none; No key is created, no embedded data is stored.

If set, this creates an embedded data key with the given name, this key will store the value of the 'count of all incorrect responses'.

You can then retrieve this value later using this key name and display it in text and rich text nodes, or use it in the tree to implement conditional branching based on performance.


11) Store total answer count as embedded data called (text)

Setting (text): Type a key-name for the embedded data.
                                

Default = none; No key is created, no embedded data is stored.

If set, this creates an embedded data key with the given name, this key will store the value of the 'count total of all responses (whether correct, incorrect or timed-out)'.

You can then retrieve this value later using this key name and display it in text and rich text nodes, or use it in the tree to implement conditional branching based on performance.


12) Store percentage correct answers as embedded data called (text)

Setting (text): Type a key-name for the embedded data.
                                

Default = none; No key is created, no embedded data is stored.

If set, this creates an embedded data key with the given name, this key will store the value of the 'percentage of all responses that were correct out of all total (correct, incorrect and timed-out) answers'. This value will be an integer between 0 and 100.

You can then retrieve this value later using this key name and display it in text and rich text nodes, or use it in the tree to implement conditional branching based on performance.

1) When clicked, record response as (text) (Mandatory)

Setting (text): Type the name-label you wish to be assigned as the recorded response identifier.

Default = none; the reaction time response will be recorded but there will be no response identifier recorded.

If set this name-label is what will be recorded in the metrics, if this button is selected as a response by a participant. This is also the label used for the purpose of determining whether the clicked button represents a correct or incorrect answer (setting-1 of Correct Answer Settings).

Click to view an Example of a Sample Project which makes use of the Response Button Paragraph (Rich Text) Zone.

Response Button (Image) Zone


The Response Button (Image) Zone adds a clickable button containing an uploaded image to your screen.
You must first upload the image in the Stimuli Tab of the Task Builder. Then type the full stimuli name (including file type) within the Response Button (Image) Zone itself or relevant spreadsheet column.

There are three sections to the Response Button (Image) Zone.

  • (Mandatory) Left side: This section of the Zone contains the main button image you wish to display on the response button. It is this same stimuli name you use in your correct answer settings.
  • (Optional) Top-Right side: You can set an additional 'Hover Image' here, this image will be shown when the participants mouse cursor is hovering over the button. (Note: non-touch devices only *)
  • (Optional) Bottom-Right side: You can set an additional 'Pressed Image', this image will be shown when the button is pressed if in addition a value is entered into Setting-2

The button's size and placement will match the Zone area you set for it. All images set to the button will be centered and rescaled to ensure it fits within the button area.

Edit the 'Active Response' Configuration Settings, to set how the button(s) will function when a participant clicks on it.

Supported Image types: .png, .jpg, and .jpeg, and .gif.

Use the Response Button (Image) Zone when you want particpants to select a correct answer via a set of Image buttons. The Response Button (Image) Zone is typically used to ask participants to 'select' a response, or 'correct answer', from a set of other button options.

Response Button (Image) Zone Icon:

Click Here To View An Image Example Of The Response Button (Image) Zone & Configuration Settings
In the example below, there are two Response Button (Image) Zones. Both Zones have image content set for the 'main button' (left-side of Zone), 'hover button' (top-right-side of Zone) and 'pressed button' (bottom-right-side of zone). Both Zones will show the pressed button image for 500ms (Setting-2). The first Response Button Zone (on the left) has been configured to hide the border from around the images (Setting-1) In the Correct Answer Settings the yellow button (Zone on the right) is set to be the correct answer (Setting-1) and Sudden Death has been turned off (Setting-2).

Configuration Settings:

The Response Button (Image) Zone is an Active Response Zone. Find out more about active responses and their corresponding 'Active Response' Configuration Setting Options here.

Click Here To View The Active Response Configuration Settings

Active Response


1) If a response's value matches (text), it represents the correct answer

Setting (text): Type a name of the correct answer (Static Content), or, correct answer column name (Spreadsheet Content).
                                

Default = none; No correct answer is set, all answers will be listed as 'incorrect' in your metrics.

If set answers matching this value will be marked as 'correct' in your metrics.


2) If (1 or 0), enable sudden death (first answer recorded only).
Note: Setting-1 must be set in order to use this setting.

Setting (1 or 0): Type 1 to turn setting on, Type 0 to turn setting off.
                                

Default = 0 (off); If the participant selects an incorrect answer the option is removed until the correct answer is chosen, at which point the participant will advance to the next screen.

If Sudden Death is set to 1 (on) the participant is only allowed a single response. Once the participant has responded the next screen is shown regardless of whether the response was correct or incorrect.


3) If (1 or 0), only score the first answer as correct
Note: Setting-2 must be set to 0 for this setting to apply.

Setting (1 or 0): Type 1 to turn setting on, Type 0 to turn setting off.
                                

Default = 0; the trial will be marked as 'correct', even if it was not the first response given.

If set to 1, trial will be marked as correct if and only if this was the first answer given.


4) Record a timeout as (text)
Note: This setting only applys if a Timelimit (screen) Zone is present.

Setting (text): set the text you wish to see recorded in the metrics when the timelimit for the screen is reached before a correct response is given.
                                

Default = none; if the timelimit is reached before a response is received, the 'response' column of your metrics will be blank.

If text is set, and the timelimit is reached before a response is received, the text is recorded under the 'response' column of your metrics.


Advanced Branching Settings


5) If correct, advance to screen (text)
Note: Setting-1 must be set in order to use this setting.

Setting (text): Type a screen name from the current display.
                                

Upon receiving a correct response, Gorilla will advance the task to the named screen within your current display.


6) If incorrect, advance to screen (text)
Note: Setting-1 must be set in order to use this setting.

Setting (text): Type a screen name from the current display.
                                

Upon receiving an incorrect response, Gorilla will advance the task to the named screen within your current display.


7) If timeout, advance to screen (text)
Note: Setting-1 must be set in order to use this setting.

Setting (text): Type a screen name from the current display.
                                

If there is a timelimit set and this expires before a response is received, Gorilla will advance the task to the named screen within your current display.


Embedded Data Settings


8) Store most recent answer as embedded data called (text)

Setting (text): Type a key-name for the embedded data.
                                

Default = none; No key is created, no embedded data is stored.

If set, this creates an embedded data key with the given name, this key will store the value of the most recent answer given.

You can then retrieve this value later using this key name and display it in text and rich text nodes, or use it in the tree to implement conditional branching.


9) Store correct answers as embedded data called (text)

Setting (text): Type a key-name for the embedded data.
                                

Default = none; No key is created, no embedded data is stored.

If set, this creates an embedded data key with the given name, this key will store the value of the 'count of all correct responses'.

You can then retrieve this value later using this key name and display it in text and rich text nodes, or use it in the tree to implement conditional branching based on performance.


10) Store incorrect answers as embedded data called (text)

Setting (text): Type a key-name for the embedded data.
                                

Default = none; No key is created, no embedded data is stored.

If set, this creates an embedded data key with the given name, this key will store the value of the 'count of all incorrect responses'.

You can then retrieve this value later using this key name and display it in text and rich text nodes, or use it in the tree to implement conditional branching based on performance.


11) Store total answer count as embedded data called (text)

Setting (text): Type a key-name for the embedded data.
                                

Default = none; No key is created, no embedded data is stored.

If set, this creates an embedded data key with the given name, this key will store the value of the 'count total of all responses (whether correct, incorrect or timed-out)'.

You can then retrieve this value later using this key name and display it in text and rich text nodes, or use it in the tree to implement conditional branching based on performance.


12) Store percentage correct answers as embedded data called (text)

Setting (text): Type a key-name for the embedded data.
                                

Default = none; No key is created, no embedded data is stored.

If set, this creates an embedded data key with the given name, this key will store the value of the 'percentage of all responses that were correct out of all total (correct, incorrect and timed-out) answers'. This value will be an integer between 0 and 100.

You can then retrieve this value later using this key name and display it in text and rich text nodes, or use it in the tree to implement conditional branching based on performance.

1) If (any), hide button border

Setting (any): Type any value name or number.

Default = 'empty' (off); The image button will have a border.

If any content is set (on), hide the border usually displayed around the button.

To re-enable the border once content has been added to this setting: Press the 'Clear Settings' button on this settings menu.


2) Show pressed button for (number) milliseconds
Note: Pressed Button Image content must be uploaded and set in order to use this setting.

Setting (number): Type the number of milliseconds you wish the 'pressed button image' to be displayed for.

Default = 0; regardless of whether a 'Pressed Button Image' is set in the Zone content, it will not be displayed.

If set the 'pressed button image' will be shown for the set number of milliseconds, upon being pressed by the participant.
This means that if the button would normally advance to the next screen, or else would normally disappear, there will be a delay of the set number of milliseconds while the 'pressed image' is shown.

Click to view an Example of a Sample Project which makes use of the Response Button (Image) Zone.


* Using Hover Images on Touch Devices:

We do not recommend using Hover images if you wish to launch your study on Touch Devices (Mobiles & Tablets).

The concept of 'Hover' does not translate for mobile devices and this feature is specifically meant for computer based studies which have mouse interaction.
Touch devices interpret hover in the only way they know how - as a separate 'press' action. Thus when clicking an image button with a 'hover' image, on a touch device, your participant will need to press twice in order to select the option.

If you do choose to use the hover image on a mobile or wish to accept mobile users for a predominatly computer based study be aware that, on touch devices, a participant will need to click twice on an image button with hover image enabled in order to progress. Therefore you can expect slightly longer reaction times from mobile/tablet users in this set-up.

Rating Scale / Likert (Passive) Zone


The Rating Scale/Likert (Passive) Zone adds a simple set of Likert boxes to your screen.

  • Edit the Zone content to set the text for each Likert-box. Each item in the Rating Scale/Likert must be separated by commas.

Participants can select one option from the Rating Scale/Likert, but their selection will not automatically record their reaction time nor advance the participant to the next screen.

Instead the participant must be provided with either a continue button, so they can manually advance the screen, or a Timelimit (Screen) Zone so the participant is advanced automatically. Alternatively, the Rating Scale/Likert (Active) Zone can be used instead.

The Rating Scale/Likert (Passive) Zone will appear as centred in the Zone's area. The width of each Likert box will resize to fit the text content.

Use the Rating Scale/Likert (Passive) Zone to allow participants to select an option from a discrete range.

Rating Scale/Likert (Passive) Zone Icon:

Click Here To View An Image Example Of The Rating Scale/Likert (Passive) Zone & Configuration Settings
In the example below, the Rating Scale/Likert (Passive) Zone, has been set up with Require Response turned on (Setting 1) this means that the participant much make a selection on the Likert before they will be allowed to advance to the next screen.

Configuration Settings:

The Rating Scale/Likert (Passive) Zone is an Passive Response Zone. Find out more about Passive Responses here.


1) If (1 or 0) require response

Setting (1 or clear (blank)): Type 1 to turn setting on, Press Clear Setting button to turn setting off.

Default = setting clear; Response is not required. Participant can advance to the next screen without submitting an answer.

If set to 1; Response is required. Participant cannot leave the Rating Scale/Likert unanswered. Participant must select an answer before continuing to next screen via a continue button etc.

Click to view a Demo of the Rating Scale/Likert (Passive) Zone.

Rating Scale / Likert (Active) Zone


The Rating Scale / Likert (Active) Zone adds a simple set of Active Response Likert boxes to your screen.

  • Edit the Zone content to set the text for each Likert-box. Each item in the Rating Scale/Likert must be separated by commas.

Participants can select one option from the Rating Scale/Likert.

  • Edit the Active Response Correct Answer Configuration Settings to set how a participants response will advance to the next screen.

The Rating Scale / Likert (Active) Zone will appear as centred in the Zone's area. The width of each Likert box will resize to fit the text content.

Use the Rating Scale / Likert (Active) Zone to allow participants to select an option from a discrete range.

Rating Scale/Likert (Active) Zone Icon:

Click Here To View An Image Example Of The Rating Scale/Likert (Active) Zone & Configuration Settings
In the example below, the Rating Scale/Likert (Active) Zone, has been set up with Sudden Death turned on (Setting 2) which means once the participant has clicked any option their answer is recorded and they will advance to the next screen. In this example there is no correct answer and so Setting-1 has been left blank.

Configuration Settings:

The Rating Scale / Likert (Active) Zone is an Active Response Zone. Find out more about active responses and their corresponding 'Active Response' Configuration Setting Options here.

Click Here To View The Active Response Configuration Settings

Active Response


1) If a response's value matches (text), it represents the correct answer

Setting (text): Type a name of the correct answer (Static Content), or, correct answer column name (Spreadsheet Content).
                                

Default = none; No correct answer is set, all answers will be listed as 'incorrect' in your metrics.

If set answers matching this value will be marked as 'correct' in your metrics.


2) If (1 or 0), enable sudden death (first answer recorded only).
Note: Setting-1 must be set in order to use this setting.

Setting (1 or 0): Type 1 to turn setting on, Type 0 to turn setting off.
                                

Default = 0 (off); If the participant selects an incorrect answer the option is removed until the correct answer is chosen, at which point the participant will advance to the next screen.

If Sudden Death is set to 1 (on) the participant is only allowed a single response. Once the participant has responded the next screen is shown regardless of whether the response was correct or incorrect.


3) If (1 or 0), only score the first answer as correct
Note: Setting-2 must be set to 0 for this setting to apply.

Setting (1 or 0): Type 1 to turn setting on, Type 0 to turn setting off.
                                

Default = 0; the trial will be marked as 'correct', even if it was not the first response given.

If set to 1, trial will be marked as correct if and only if this was the first answer given.


4) Record a timeout as (text)
Note: This setting only applys if a Timelimit (screen) Zone is present.

Setting (text): set the text you wish to see recorded in the metrics when the timelimit for the screen is reached before a correct response is given.
                                

Default = none; if the timelimit is reached before a response is received, the 'response' column of your metrics will be blank.

If text is set, and the timelimit is reached before a response is received, the text is recorded under the 'response' column of your metrics.


Advanced Branching Settings


5) If correct, advance to screen (text)
Note: Setting-1 must be set in order to use this setting.

Setting (text): Type a screen name from the current display.
                                

Upon receiving a correct response, Gorilla will advance the task to the named screen within your current display.


6) If incorrect, advance to screen (text)
Note: Setting-1 must be set in order to use this setting.

Setting (text): Type a screen name from the current display.
                                

Upon receiving an incorrect response, Gorilla will advance the task to the named screen within your current display.


7) If timeout, advance to screen (text)
Note: Setting-1 must be set in order to use this setting.

Setting (text): Type a screen name from the current display.
                                

If there is a timelimit set and this expires before a response is received, Gorilla will advance the task to the named screen within your current display.


Embedded Data Settings


8) Store most recent answer as embedded data called (text)

Setting (text): Type a key-name for the embedded data.
                                

Default = none; No key is created, no embedded data is stored.

If set, this creates an embedded data key with the given name, this key will store the value of the most recent answer given.

You can then retrieve this value later using this key name and display it in text and rich text nodes, or use it in the tree to implement conditional branching.


9) Store correct answers as embedded data called (text)

Setting (text): Type a key-name for the embedded data.
                                

Default = none; No key is created, no embedded data is stored.

If set, this creates an embedded data key with the given name, this key will store the value of the 'count of all correct responses'.

You can then retrieve this value later using this key name and display it in text and rich text nodes, or use it in the tree to implement conditional branching based on performance.


10) Store incorrect answers as embedded data called (text)

Setting (text): Type a key-name for the embedded data.
                                

Default = none; No key is created, no embedded data is stored.

If set, this creates an embedded data key with the given name, this key will store the value of the 'count of all incorrect responses'.

You can then retrieve this value later using this key name and display it in text and rich text nodes, or use it in the tree to implement conditional branching based on performance.


11) Store total answer count as embedded data called (text)

Setting (text): Type a key-name for the embedded data.
                                

Default = none; No key is created, no embedded data is stored.

If set, this creates an embedded data key with the given name, this key will store the value of the 'count total of all responses (whether correct, incorrect or timed-out)'.

You can then retrieve this value later using this key name and display it in text and rich text nodes, or use it in the tree to implement conditional branching based on performance.


12) Store percentage correct answers as embedded data called (text)

Setting (text): Type a key-name for the embedded data.
                                

Default = none; No key is created, no embedded data is stored.

If set, this creates an embedded data key with the given name, this key will store the value of the 'percentage of all responses that were correct out of all total (correct, incorrect and timed-out) answers'. This value will be an integer between 0 and 100.

You can then retrieve this value later using this key name and display it in text and rich text nodes, or use it in the tree to implement conditional branching based on performance.

1) If (1 or 0) allow unlimited responses (disables advance on correct response)

Setting (1 or 0): Type 1 to turn setting on, Type 0 to turn setting off.

Default = 0; Participant will advance to the next screen as you have specified in the Active Response Settings.

If set to 1; Participants can make unlimited responses. A correct answer (Active Response Setting-1) will not advance the participant to the next screen. Instead you must use a Continue Button or Timelimit (Screen) Zone (or a different active response zone) to advance the participant to the next screen.

Note:

  • A Reaction time is recorded for each response selected.
  • Each response will still be scored as 'Correct' if they match the value in the 'Correct Answer' Setting (Active Response Setting-1).
  • If Active Response Setting-3 is enabled, only the first answer will be score as correct regardless of how many correct answers are submitted.

Click to view a Demo of the Rating Scale/Likert (Active) Zone.

Response Slider Zone


The Response Slider Zone adds a simple slider to your screen. The participant can drag the slider to a value within the range you set. The range defaults to 0 - 100.

  • Edit the Zone's configuration settings to customise the slider.

The Slider will appear as centred in the Zone's area and the slider width will match the Zone width. If desired add labels for your slider using Text or Image Content Zones.

Use the Response Slider Zone to allow participants to select a value from a range. The Response Slider Zone is typically used when you wish a participant to rate an answer on a scale that does not require an Active Response. If an Active Response is required we recommend you use the Rating Scale/Likert (Active) Zone instead.

Response Slider Zone Icon:

Click Here To View An Image Example Of The Response Slider Zone & Configuration Settings
In the example below, the Response Slider Zone has been set up with a minimum value of 0 (Setting 4) and a maximum value of 10 (Setting 5). The slider will start at 5 (Setting 2) and the tooltip is turned on (Setting 6) meaning the slider value will be shown to the participant as they choose a response. Setting 7, 'require response', has been turned on (set to 1) this means the Participant will be required to interact with the slider to submit a response, before they can advance the task screen via the continue button.

Configuration Settings:

The Response Slider Zone is a Passive Response Zone. Find out more about Passive Responses here.


1) If (1 or 0), hide the slider handle until first click (this will override the two settings below)

Setting (1 or 0): Type 1 to turn setting on, Type 0 to turn setting off.

Default = 0

If set to 1; there is no visible 'handle' marking the start value of the slider.
Settings-2 & setting-3 will be overwritten and the actual default starting value will be 0.


2) Start slider at (number) (min)

Setting (number): Type a number to set the minimum start value for the slider.

Default = 50

To start the slider at a single point; set only the minimum value for the starting position of the slider.

To start the slider at a random position within a range, use both setting-2 (min) and setting-3 (max) to define the range.


3) Start slider at (number) (max)

Setting (number): Type a number to set the maximum start value for the slider.

Default = none

To start the slider at a single point; set only setting-1 (min).

To start the slider at a random position within a range, use both setting-2 (min) and setting-3 (max) to define the range.


4) Use slider min value of (number)

Setting (number): Type a number to set the minimum value of the slider.

Default = 0

Set the minimum value for the slider (i.e. the value at the leftmost end).


5) Use slider max value of (number)

Setting (number): Type a number to set the maximum value of the slider.

Default = 100

Set the maximum value for the slider (i.e. the value at the rightmost end).


6) If (1 or 0), show the slider tooltip

Setting (1 or 0): Type 1 to turn setting on, Type 0 to turn setting off.

Default = 0

If set to 1, shows a tooltip with the current slider value, allowing your participants to see the exact value they are entering.


7) If (1 or 0), disable slider input

Setting (1 or 0): Type 1 to turn setting on, Type 0 to turn setting off.

Default = 0

If set to 1, disables any slider input, so the slider merely displays a value, rather than allowing the participant to enter a response.

This setting is typically used to present a slider as a stimuli used to influence a users subsequent response.


8) If (1 or 0), require response

Setting (1 or 0): Type 1 to turn setting on, Type 0 to turn setting off.

Default = 0

If set to 1, prevents participants from progressing to the next screen without moving the slider (giving a response).

Click to view a Demo of the Response Slider Zone.

Keyboard Response (Single) Zone


The Keyboard Response (Single) Zone adds a single keyboard response option to your screen.

  • Edit the Zone content to enter a line of text to display (usually a prompt telling the participant which key to press)
  • Edit the Zones Configuration settings to set which key the participant will use to respond.
  • Edit the 'Active Response' Configuration Settings to set how the key response will function when a participant presses it.

Any text entered into the Keyboard Response (Single) Zone will be unformatted and centred within the Zone area.

Use the Keyboard Response (Single) Zone when you want participants to respond via their keyboard to select a correct answer. The Keyboard Response (Single) Zone, is typically used to ask participants to 'select' a response, or 'correct answer', from a set of other Keyboard response options.

You can use multiple Keyboard Response (Single) Zones on the same screen. For example, if you need 4 keyboard options, use 4 Keyboard Response (Single) Zones on a Screen.

Keyboard Response (Single) Zone Icon:

Click Here To View An Image Example Of The Keyboard Response (Single) Zone & Configuration Settings
In the example below, 2 Keyboard Response (Single) Zones, have been set up so that keys 'e' and 'i' are mapped to responses, 'correct' and 'incorrect' respectively. The correct answer is set as static content 'Correct' (Correct Answer: Setting 1).

Configuration Settings:

The Keyboard Response (Single) Zone is an Active Response Zone. Find out more about active responses and their corresponding 'Active Response' Configuration Setting Options here.

Click Here To View The Active Response Configuration Settings

Active Response


1) If a response's value matches (text), it represents the correct answer

Setting (text): Type a name of the correct answer (Static Content), or, correct answer column name (Spreadsheet Content).
                                

Default = none; No correct answer is set, all answers will be listed as 'incorrect' in your metrics.

If set answers matching this value will be marked as 'correct' in your metrics.


2) If (1 or 0), enable sudden death (first answer recorded only).
Note: Setting-1 must be set in order to use this setting.

Setting (1 or 0): Type 1 to turn setting on, Type 0 to turn setting off.
                                

Default = 0 (off); If the participant selects an incorrect answer the option is removed until the correct answer is chosen, at which point the participant will advance to the next screen.

If Sudden Death is set to 1 (on) the participant is only allowed a single response. Once the participant has responded the next screen is shown regardless of whether the response was correct or incorrect.


3) If (1 or 0), only score the first answer as correct
Note: Setting-2 must be set to 0 for this setting to apply.

Setting (1 or 0): Type 1 to turn setting on, Type 0 to turn setting off.
                                

Default = 0; the trial will be marked as 'correct', even if it was not the first response given.

If set to 1, trial will be marked as correct if and only if this was the first answer given.


4) Record a timeout as (text)
Note: This setting only applys if a Timelimit (screen) Zone is present.

Setting (text): set the text you wish to see recorded in the metrics when the timelimit for the screen is reached before a correct response is given.
                                

Default = none; if the timelimit is reached before a response is received, the 'response' column of your metrics will be blank.

If text is set, and the timelimit is reached before a response is received, the text is recorded under the 'response' column of your metrics.


Advanced Branching Settings


5) If correct, advance to screen (text)
Note: Setting-1 must be set in order to use this setting.

Setting (text): Type a screen name from the current display.
                                

Upon receiving a correct response, Gorilla will advance the task to the named screen within your current display.


6) If incorrect, advance to screen (text)
Note: Setting-1 must be set in order to use this setting.

Setting (text): Type a screen name from the current display.
                                

Upon receiving an incorrect response, Gorilla will advance the task to the named screen within your current display.


7) If timeout, advance to screen (text)
Note: Setting-1 must be set in order to use this setting.

Setting (text): Type a screen name from the current display.
                                

If there is a timelimit set and this expires before a response is received, Gorilla will advance the task to the named screen within your current display.


Embedded Data Settings


8) Store most recent answer as embedded data called (text)

Setting (text): Type a key-name for the embedded data.
                                

Default = none; No key is created, no embedded data is stored.

If set, this creates an embedded data key with the given name, this key will store the value of the most recent answer given.

You can then retrieve this value later using this key name and display it in text and rich text nodes, or use it in the tree to implement conditional branching.


9) Store correct answers as embedded data called (text)

Setting (text): Type a key-name for the embedded data.
                                

Default = none; No key is created, no embedded data is stored.

If set, this creates an embedded data key with the given name, this key will store the value of the 'count of all correct responses'.

You can then retrieve this value later using this key name and display it in text and rich text nodes, or use it in the tree to implement conditional branching based on performance.


10) Store incorrect answers as embedded data called (text)

Setting (text): Type a key-name for the embedded data.
                                

Default = none; No key is created, no embedded data is stored.

If set, this creates an embedded data key with the given name, this key will store the value of the 'count of all incorrect responses'.

You can then retrieve this value later using this key name and display it in text and rich text nodes, or use it in the tree to implement conditional branching based on performance.


11) Store total answer count as embedded data called (text)

Setting (text): Type a key-name for the embedded data.
                                

Default = none; No key is created, no embedded data is stored.

If set, this creates an embedded data key with the given name, this key will store the value of the 'count total of all responses (whether correct, incorrect or timed-out)'.

You can then retrieve this value later using this key name and display it in text and rich text nodes, or use it in the tree to implement conditional branching based on performance.


12) Store percentage correct answers as embedded data called (text)

Setting (text): Type a key-name for the embedded data.
                                

Default = none; No key is created, no embedded data is stored.

If set, this creates an embedded data key with the given name, this key will store the value of the 'percentage of all responses that were correct out of all total (correct, incorrect and timed-out) answers'. This value will be an integer between 0 and 100.

You can then retrieve this value later using this key name and display it in text and rich text nodes, or use it in the tree to implement conditional branching based on performance.


1)

If (key) is pressed

Setting (key): Type the key mapping to be used for the response.

Default = None; No key is mapped to the Response Zone.

To map a key to a response: Enter the letter of the key you wish to detect (e.g. a for the A key).
Alternatively, use any of the following special key mappings:

  • space for the Space Bar key
  • left for the Left Arrow key
  • right for the Right Arrow key
  • up for the Up Arrow key
  • down for the Down Arrow key
  • enter for the enter key
  • backspace for the backspace key
  • delete for the delete key

2) record response as (text) (Mandatory)

Setting (text): Type the name-label you wish to be assigned as the recorded response identifier.

Default = None; No response will be recorded in the metrics.

When set, this name-label (identifier) is what will be recorded in the metrics, if this key response is selected by the participant. This is also the label used for the purpose of determining whether the clicked button represents a correct or incorrect answer (setting-1 of Correct Answer Settings).


3) If (1 or 0) allow unlimited responses (disables advance on correct response)

Setting (1 or 0): Type 1 to turn setting on, Type 0 to turn setting off.

Default = 0; Participant will advance to the next screen as you have specified in the Active Response Settings.

If set to 1; Participants can make unlimited responses. A correct answer (Active Response Setting-1) will not advance the participant to the next screen. Instead you must use a Continue Button or Timelimit (Screen) Zone (or a different active response zone) to advance the participant to the next screen.

Note:

  • A Reaction time is recorded for each response selected.
  • Each response will still be scored as 'Correct' if they match the value in the 'Correct Answer' Setting (Active Response Setting-1).
  • If Active Response Setting-3 is enabled, only the first answer will be score as correct regardless of how many correct answers are submitted.

Click to view an Example of a Sample Project which makes use of the Keyboard Response (Single) Zone.

Keyboard Response Zone


The Keyboard Response Zone is identical in function to the Keyboard Response (Single) Zone except that it adds two keyboard response options to your screen.

  • Edit the Zone content to enter a line of text to display (usually a prompt telling the participant which keys to press)
  • Edit the Zones Configuration settings to set which key the participant will use to respond.
  • Edit the 'Active Response' Configuration Settings to set how the key response will function when a participant presses it.

Any text entered into the Keyboard Response Zone will be unformatted and centred within the Zone area.

The Keyboard Response Zone, is typically used when you want participants to respond via their keyboard to select a correct answer between 2 different options.

You can use multiple Keyboard Response Zones on the same screen. For example, if you need 4 keyboard options, use 2 Keyboard Response Zones on a Screen.

Keyboard Response Zone Icon:

Click Here To View An Image Example Of The Keyboard Response Zone & Configuration Settings
In the example below, the Keyboard Response Zone, has been set up so that left-arrow and right-arrow keys are mapped to responses, 'Left' and 'Right' respectively. The correct answer is set as static content 'Right' (Correct Answer: Setting 1). Sudden death is turned on (Correct Answer: Setting 2), once the participant gives either key response they will advanace to the next screen.

Configuration Settings:

The Keyboard Response Zone is an Active Response Zone. Find out more about active responses and their corresponding 'Active Response' Configuration Setting Options here.

Click Here To View The Active Response Configuration Settings

Active Response


1) If a response's value matches (text), it represents the correct answer

Setting (text): Type a name of the correct answer (Static Content), or, correct answer column name (Spreadsheet Content).
                                

Default = none; No correct answer is set, all answers will be listed as 'incorrect' in your metrics.

If set answers matching this value will be marked as 'correct' in your metrics.


2) If (1 or 0), enable sudden death (first answer recorded only).
Note: Setting-1 must be set in order to use this setting.

Setting (1 or 0): Type 1 to turn setting on, Type 0 to turn setting off.
                                

Default = 0 (off); If the participant selects an incorrect answer the option is removed until the correct answer is chosen, at which point the participant will advance to the next screen.

If Sudden Death is set to 1 (on) the participant is only allowed a single response. Once the participant has responded the next screen is shown regardless of whether the response was correct or incorrect.


3) If (1 or 0), only score the first answer as correct
Note: Setting-2 must be set to 0 for this setting to apply.

Setting (1 or 0): Type 1 to turn setting on, Type 0 to turn setting off.
                                

Default = 0; the trial will be marked as 'correct', even if it was not the first response given.

If set to 1, trial will be marked as correct if and only if this was the first answer given.


4) Record a timeout as (text)
Note: This setting only applys if a Timelimit (screen) Zone is present.

Setting (text): set the text you wish to see recorded in the metrics when the timelimit for the screen is reached before a correct response is given.
                                

Default = none; if the timelimit is reached before a response is received, the 'response' column of your metrics will be blank.

If text is set, and the timelimit is reached before a response is received, the text is recorded under the 'response' column of your metrics.


Advanced Branching Settings


5) If correct, advance to screen (text)
Note: Setting-1 must be set in order to use this setting.

Setting (text): Type a screen name from the current display.
                                

Upon receiving a correct response, Gorilla will advance the task to the named screen within your current display.


6) If incorrect, advance to screen (text)
Note: Setting-1 must be set in order to use this setting.

Setting (text): Type a screen name from the current display.
                                

Upon receiving an incorrect response, Gorilla will advance the task to the named screen within your current display.


7) If timeout, advance to screen (text)
Note: Setting-1 must be set in order to use this setting.

Setting (text): Type a screen name from the current display.
                                

If there is a timelimit set and this expires before a response is received, Gorilla will advance the task to the named screen within your current display.


Embedded Data Settings


8) Store most recent answer as embedded data called (text)

Setting (text): Type a key-name for the embedded data.
                                

Default = none; No key is created, no embedded data is stored.

If set, this creates an embedded data key with the given name, this key will store the value of the most recent answer given.

You can then retrieve this value later using this key name and display it in text and rich text nodes, or use it in the tree to implement conditional branching.


9) Store correct answers as embedded data called (text)

Setting (text): Type a key-name for the embedded data.
                                

Default = none; No key is created, no embedded data is stored.

If set, this creates an embedded data key with the given name, this key will store the value of the 'count of all correct responses'.

You can then retrieve this value later using this key name and display it in text and rich text nodes, or use it in the tree to implement conditional branching based on performance.


10) Store incorrect answers as embedded data called (text)

Setting (text): Type a key-name for the embedded data.
                                

Default = none; No key is created, no embedded data is stored.

If set, this creates an embedded data key with the given name, this key will store the value of the 'count of all incorrect responses'.

You can then retrieve this value later using this key name and display it in text and rich text nodes, or use it in the tree to implement conditional branching based on performance.


11) Store total answer count as embedded data called (text)

Setting (text): Type a key-name for the embedded data.
                                

Default = none; No key is created, no embedded data is stored.

If set, this creates an embedded data key with the given name, this key will store the value of the 'count total of all responses (whether correct, incorrect or timed-out)'.

You can then retrieve this value later using this key name and display it in text and rich text nodes, or use it in the tree to implement conditional branching based on performance.


12) Store percentage correct answers as embedded data called (text)

Setting (text): Type a key-name for the embedded data.
                                

Default = none; No key is created, no embedded data is stored.

If set, this creates an embedded data key with the given name, this key will store the value of the 'percentage of all responses that were correct out of all total (correct, incorrect and timed-out) answers'. This value will be an integer between 0 and 100.

You can then retrieve this value later using this key name and display it in text and rich text nodes, or use it in the tree to implement conditional branching based on performance.


1 & 3)

If (key) is pressed

Setting (key): Type the key mapping to be used for the response.

Default = None; No key is mapped to the Response Zone.

To map a key to a response: Enter the letter of the key you wish to detect (e.g. a for the A key).
Alternatively, use any of the following special key mappings:

  • space for the Space Bar key
  • left for the Left Arrow key
  • right for the Right Arrow key
  • up for the Up Arrow key
  • down for the Down Arrow key
  • enter for the enter key
  • backspace for the backspace key
  • delete for the delete key

2 & 4) record response as (text) (Mandatory)

Setting (text): Type the name-label you wish to be assigned as the recorded response identifier.

Default = None; No response will be recorded in the metrics.

When set, this name-label (identifier) is what will be recorded in the metrics, if this key response is selected by the participant. This is also the label used for the purpose of determining whether the clicked button represents a correct or incorrect answer (setting-1 of Correct Answer Settings).

5) If (1 or 0) allow unlimited responses (disables advance on correct response)

Setting (1 or 0): Type 1 to turn setting on, Type 0 to turn setting off.

Default = 0; Participant will advance to the next screen as you have specified in the Active Response Settings.

If set to 1; Participants can make unlimited responses. A correct answer (Active Response Setting-1) will not advance the participant to the next screen. Instead you must use a Continue Button or Timelimit (Screen) Zone (or a different active response zone) to advance the participant to the next screen.

Note:

  • A Reaction time is recorded for each response selected.
  • Each response will still be scored as 'Correct' if they match the value in the 'Correct Answer' Setting (Active Response Setting-1).
  • If Active Response Setting-3 is enabled, only the first answer will be score as correct regardless of how many correct answers are submitted.

Click to view a Classical Thatcher Example which makes use of the Keyboard Response (Multi) Zone.

Space to Continue Zone


The Space to Continue Zone allows the participant to advance to the next screen using their keyboard's Space bar. Once the participant presses the Space bar, the screen is advanced and the reaction time is recorded in the metrics at this point.

  • Edit the Zone content to display a single line of unformatted text - usually a prompt telling the participant to press the space bar to continue

The text will appear as centred in the Zone's area.

Use the Space to Continue Zone to allow particpants to manually advance to the next screen using their keyboard. The Space to Continue Zone is typically used when you are using keyboard response and do not want your participant to take their hands off the keyboard to progress from instructions to the tasks' trials.

Space to Continue Zone Icon:

Configuration Settings:

The Space to Continue Zone is an Passive Response Zone. Find out more about Passive Responses here.


-- No Settings --

Click to view a Classical Thatcher Example which makes use of the Space To Continue Zone.

Response Text Zone


The Response Text Zone adds a simple text entry box to your screen, which allows the participant to enter a single line of text.

The participant must press the Enter key to submit their response.

  • Edit the 'Active Response' Configuration Settings to set how the Response Text Zone will function when a participant submits a text entry.

The Text Entry box will appear as centred in the Zone's area. The width of the Text Entry box will resize to match the Zone width.

Use the Response Text Zone when you want participants to enter a single word or sentence as a response to your question.

Response Text Zone Icon:

Click Here To View An Image Example Of The Response Text Zone & Configuration Settings
In the example below, the Response Text Zone, has been set up so that the correct answer is set, as static content, to 'Next' (Active Response:Setting 1). Sudden Death is turned off (Active Response: Setting-2) - i.e. they are allowed multiple attempts to get the correct answer - which means the participant will only advance to the next screen once they type in the correct answer and press the Enter key (Setting 1). The reaction time is recorded for each entry only once the participant presses the enter key to submit the answer. In this case we aim to record how long it takes the participant to submit the correct answer. Response Text Setting-3 has not been set as the participant has no passive means to advance the screen. As a response is set to 'not required' this does mean the participant can submit blank or 'empty' entrys.
Image of Response Text Zone configuration settings

Configuration Settings:

The Response Text Zone is an Active Response Zone. Find out more about active responses and their corresponding 'Active Response' Configuration Setting Options here.

Click Here To View The Active Response Configuration Settings

Active Response


1) If a response's value matches (text), it represents the correct answer

Setting (text): Type a name of the correct answer (Static Content), or, correct answer column name (Spreadsheet Content).
                                

Default = none; No correct answer is set, all answers will be listed as 'incorrect' in your metrics.

If set answers matching this value will be marked as 'correct' in your metrics.


2) If (1 or 0), enable sudden death (first answer recorded only).
Note: Setting-1 must be set in order to use this setting.

Setting (1 or 0): Type 1 to turn setting on, Type 0 to turn setting off.
                                

Default = 0 (off); If the participant selects an incorrect answer the option is removed until the correct answer is chosen, at which point the participant will advance to the next screen.

If Sudden Death is set to 1 (on) the participant is only allowed a single response. Once the participant has responded the next screen is shown regardless of whether the response was correct or incorrect.


3) If (1 or 0), only score the first answer as correct
Note: Setting-2 must be set to 0 for this setting to apply.

Setting (1 or 0): Type 1 to turn setting on, Type 0 to turn setting off.
                                

Default = 0; the trial will be marked as 'correct', even if it was not the first response given.

If set to 1, trial will be marked as correct if and only if this was the first answer given.


4) Record a timeout as (text)
Note: This setting only applys if a Timelimit (screen) Zone is present.

Setting (text): set the text you wish to see recorded in the metrics when the timelimit for the screen is reached before a correct response is given.
                                

Default = none; if the timelimit is reached before a response is received, the 'response' column of your metrics will be blank.

If text is set, and the timelimit is reached before a response is received, the text is recorded under the 'response' column of your metrics.


Advanced Branching Settings


5) If correct, advance to screen (text)
Note: Setting-1 must be set in order to use this setting.

Setting (text): Type a screen name from the current display.
                                

Upon receiving a correct response, Gorilla will advance the task to the named screen within your current display.


6) If incorrect, advance to screen (text)
Note: Setting-1 must be set in order to use this setting.

Setting (text): Type a screen name from the current display.
                                

Upon receiving an incorrect response, Gorilla will advance the task to the named screen within your current display.


7) If timeout, advance to screen (text)
Note: Setting-1 must be set in order to use this setting.

Setting (text): Type a screen name from the current display.
                                

If there is a timelimit set and this expires before a response is received, Gorilla will advance the task to the named screen within your current display.


Embedded Data Settings


8) Store most recent answer as embedded data called (text)

Setting (text): Type a key-name for the embedded data.
                                

Default = none; No key is created, no embedded data is stored.

If set, this creates an embedded data key with the given name, this key will store the value of the most recent answer given.

You can then retrieve this value later using this key name and display it in text and rich text nodes, or use it in the tree to implement conditional branching.


9) Store correct answers as embedded data called (text)

Setting (text): Type a key-name for the embedded data.
                                

Default = none; No key is created, no embedded data is stored.

If set, this creates an embedded data key with the given name, this key will store the value of the 'count of all correct responses'.

You can then retrieve this value later using this key name and display it in text and rich text nodes, or use it in the tree to implement conditional branching based on performance.


10) Store incorrect answers as embedded data called (text)

Setting (text): Type a key-name for the embedded data.
                                

Default = none; No key is created, no embedded data is stored.

If set, this creates an embedded data key with the given name, this key will store the value of the 'count of all incorrect responses'.

You can then retrieve this value later using this key name and display it in text and rich text nodes, or use it in the tree to implement conditional branching based on performance.


11) Store total answer count as embedded data called (text)

Setting (text): Type a key-name for the embedded data.
                                

Default = none; No key is created, no embedded data is stored.

If set, this creates an embedded data key with the given name, this key will store the value of the 'count total of all responses (whether correct, incorrect or timed-out)'.

You can then retrieve this value later using this key name and display it in text and rich text nodes, or use it in the tree to implement conditional branching based on performance.


12) Store percentage correct answers as embedded data called (text)

Setting (text): Type a key-name for the embedded data.
                                

Default = none; No key is created, no embedded data is stored.

If set, this creates an embedded data key with the given name, this key will store the value of the 'percentage of all responses that were correct out of all total (correct, incorrect and timed-out) answers'. This value will be an integer between 0 and 100.

You can then retrieve this value later using this key name and display it in text and rich text nodes, or use it in the tree to implement conditional branching based on performance.

1) If (1 or 0) disable the Enter key

Setting (1 or 0): Type 1 to turn setting on, Type 0 to turn setting off.

Default = 0; Normally, the participant presses the Enter key to submit their response.

If Set to 1; the Enter key is disabled for response submission. Instead use a Continue Button Zone or a Timelimit(Screen) Zone to allow the participant to manually advance to the next screen. In this case, the value entered in to the Response Text Zone will be collected as a Passive Response Zone.


2) If (1 or 0) collect reaction times after first key press (only valid if using enter key)
Note: To use this, Setting-1 must be turned off (0).

Setting (1 or 0): Type 1 to turn setting on, Type 0 to turn setting off.

Default = 0; When the answer is submitted via the entry key, the Reaction Time and Value is recorded in the metrics at this point.

If set to 1; The Reaction Time is recorded upon the first key press. Use this option when you wish to know the reaction time for a participants time to start responding.


3) If (1 or 0) require response

Setting (1 or 0): Type 1 to turn setting on, Type 0 to turn setting off.

Default = 0; Response is not required. Participant can submit blank/empty entrys and advance the screen without submitting an answer.

If set to 1; Response is required. Participant cannot leave the response text field blank/empty. Participant must type an answer before continuing to next screen via a continue button etc.

Click to view a Demo of the Response Text Zone.

Response Text (Multi) Zone


The Response Text (Multi) Zone adds a simple text entry box to your screen which allows the participant to enter multiple text answers.

The participant must press the Enter key to submit each response. Each response is scored individually, and will generate its own row in the metrics data.

  • Edit the Zone content to set a list of correct answers. Each correct answer must be separated by commas.

The responses are not case-sensitive, meaning that responses 'cat' and 'Cat' will both be marked as correct.

The Text Entry box will appear as centred in the Zone's area. The width of the Text Entry box will resize to match the Zone width.

Use the Response Text (Multi) Zone is typically used to allow participants to submit multiple text entry responses to a single question, e.g. in a memory recall task.

Response Text (Multi) Zone Icon:

Configuration Settings:

The Response Text (Multi) Zone is an Passive Response Zone. Find out more about Passive Responses here.


-- No Settings --

Click to view a Classic Primacy and Recency Example Project which makes use of the Response Text (Multi) Zone.

Response Text Area Zone


The Response Text Area Zone adds a simple text entry box to your screen which encourages the participant to submit a longer length answer.

The Text Entry box will appear as centred in the Zone's area. The width of the Text Entry box will resize to match the Zone width.

  • Edit the Zone configuration setting to set the number of rows you wish the Text Entry area to span.

The Response Text Area Zone is typically used when you wish participants to submit a more detailed text entry response, as multiple lines of text, to your questions.

Response Text Area Zone Icon:

Click Here To View An Image Example Of The Response Text Area Zone & Configuration Settings
In the example below, the Response Text Area Zone, has been set up to be 20 rows high (Setting-1). The 'require response' (Setting-2) has been enabled (set to 1). This means the participant is required to submit a response before they can continue to the next screen.

Configuration Settings:

The Response Text Area Zone is an Passive Response Zone. Find out more about Passive Responses here.


1) Number of rows to be used in the text area: (number)

Setting (number): Set the number of rows used in the text area.

Default = 1


2) If (1 or 0) require response

Setting (1 or 0): Type 1 to turn setting on, Type 0 to turn setting off.

Default = 0; Response is not required. Participant can submit blank/empty entrys and advance the screen without submitting an answer.

If set to 1; Response is required. Participant cannot leave the response text field blank/empty. Participant must type an answer before continuing to next screen via a continue button etc.

Click to view an Example of a Sample Project which makes use of the Response Text Area Zone.

Change Blindness Zone


The Change Blindness Zone is an advanced content zone which allows you to repeatedly display a set of two image stimuli, interleaved with a mask image, for controlled time periods set in the configurations settings. This allows you to present simultaneous images to your participant on the same screen. This special zone provides additional image display accuracy necessary for a 'Change Blindness' Task.

The Change Blindness Zone is made up of 3 sections. Edit the Zone Content to add both your image stimuli and mask stimuli for each section.

  • Left Section: Image Stimuli 1 - Enter the full address for your first image stimuli here. e.g. myChangeBlindnessImage1.PNG
  • Middle Section: Mask Stimuli - Enter the full address for your mask image stimuli here. e.g. myChangeBlindnesssMask.PNG
  • Right Section: Image Stimuli 2 - Enter the full address for your second image stimuli here. e.g. myChangeBlindnessImage2.PNG

You can also Edit the Change Blindness Configuration Settings to set both images and the mask durations.

The images and mask images will auto-resize to fit the Zone's area and be centred within the Zone area. This means the image will be displayed as large as possible within the Zone's area, but will not be stretched or enlarged above it's natural, uploaded, size. For best results, you should ensure the images you use for each section of the Change Blindness Zone are the same size (height and width).

Supported Image types: .png, .jpg, .jpeg, and .gif

Typically the Change Blindness Zone is used when you wish to set up a Change Blindness style task. You can use any Response Zone to allow the participant to indicate when they have seen the change and advance the screen.

Change Blindness Zone Icon:
image of change blindness zone icon

Click Here To View An Image Example Of The Change Blindness Zone & Configuration Settings
In the example below, the Change Blindness Zone, has been set up so that the images used for each section are taken from the spreadsheet columns, 'Image 1', 'Mask' and 'Image 2' respectively. The images will be shown for a duration of 200ms each (Setting 1) and the mask will be shown for a duration of 500 ms (Setting 2).
Image example of Change Blindness Zone

Configuration Settings:

1) Show change blindness image for (number) milliseconds

Setting (number): Type a time, as a number of milliseconds (ms), to represent the total duration for which each image stimuli will be displayed.

Default = 0; The image stimuli will not be displayed.

When set, the image stimuli used within the Change Blindness Zone will be displayed for this duration.


2) how change blindness mask for (number) milliseconds

Setting (number): Type a time, as a number of milliseconds (ms), to represent the total duration for which the mask image stimuli will be displayed.

Default = 0; The mask stimuli will not be displayed.

When set, the mask stimuli used within the Change Blindness Zone will be displayed for this duration.

Click to view a Tutorial of the Change Blindness Zone.

Click to view an Example of a Sample Project which makes use of the Change Blindness Zone.

Go/No-Go Zone


The Go/No-Go Zone is a Zone specialised for implementing go/no-go style experimental paradigms. This specialised Zone allows you to present a main image stimuli followed by either a blank screen, a fixation cross or a second 'wait image'. The Go/No-Go Zone simultanteously grants the additional functionality of recording a 'NoGo' response or an 'inhibited' response as a named response.

The Go/No-Go Zone differs from other response zones, which record all 'non-responses' as both 'incorrect' and 'timed-out'. Once the requisite times have elapsed and no other response has been detected, the Go/No-Go Zone will record a 'No Go' response. You can use any Active Response Zone - e.g. response button or keyboard response - to detect the 'Go' response.

The Go/No-Go Zone is made up of 2 sections. Edit the Zone Content to add both your 'main image' stimuli and your 'wait image' stimuli for each section:

  • Left Section: Main Image Stimuli - Enter the full address for your main image stimuli here. e.g. myGoNoGoMainImage.PNG
  • Right Section: Wait Image Stimuli - Enter the full address for your wait image stimuli here. e.g. myGoNoGoWaitImage.PNG

Supported Image types: .png, .jpg, .jpeg, and .gif.

Note: If you wish to use Audio Stimuli instead of Image stimuli you will need to use the Audio Go/No-Go Zone.

You can set the duration times for the 'main image' and 'wait image' in the Go/No-Go Zone's configuration settings:

  • Edit the Go/No-Go Zone's Configuration Settings to set how the Go/No-Go should function.

The Go/No-Go Zone is primarily used for implementing go/no-go experimental paradigms. However this Zone is also highly appilcable to Visual search and Stimulus-Response compatibility tasks.

Go/No-Go Zone Icon:

Click Here To View An Image Example Of The Go/No-Go Zone & Configuration Settings

In the example below, the Go/No-Go Zone is set to show the main image for a duration of 500 ms (configuration setting-1). The first section of the Go/No-Go Zone has been set to Spreadsheet Source and called 'Main_Image'. Therefore, the filenames for the images which will be used in this section are contained in the corresponding spreadsheet column called 'Main_Image'.

The Second section of the Go/No-Go Zone has been left empty. Instead we have set the Go/No-Go Zone to use the standard fixation cross during the wait period (configuration setting-3 is set to the value 1). The Wait duration has also been set to 500 ms via configuration setting-2.

We have set up the Go/No-Go Zone to record a 'No Go' response as the default nogo (configuration setting-4). Lastly, we have specified in, configuration setting-5, that the screen should wait to display the full image and wait time for the Go/No-Go Zone, regardless of whether the participant responds or not.

Note: The Go/No-Go Zone does not have a response option built-in. Instead we have choosen to use two Response Button (Text) Zones for the participants to submit their response.

Configuration Settings:

1) Show Go No Go image for (number) milliseconds

Setting (number): Type a time, as a number of milliseconds (ms), to represent the total duration for which the main image stimuli will be displayed.

Default = 500; The image will be shown for 500 milliseconds.

When set, the image stimuli used within the main-section of the Go/No-Go Zone will be displayed for the specified duration.


2) Wait time after image of (number) milliseconds

Setting (number): Type a time, as a number of milliseconds (ms), to represent the total duration for the wait  time after the main image stimuli has been shown.

Default = 500; The screen will wait for 500 milliseconds.
Note: If a 'wait image' or fixation cross (setting-3) is set, then this value instead represents the duration for which the wait image or fixation cross will be shown.

If set, after the main image duration has elapsed, the 'wait image' or 'fixation cross' will be displayed for this duration. Otherwise, if no 'wait image' or fixation cross is being used, the screen will wait for this duration.


3) If (1 or 0) show a fixation cross during the wait time

Setting (1 or 0): Type 1 to turn setting on, Type 0 to turn setting off.

Default = 1 (on); A fixation cross will be shown for the duration of the wait time (Setting-2).

Note: If you wish to use this setting you must leave the content for the 'wait image' section empty.

If set to 0 (off); (and the content for the 'wait image' Zone section is empty) then nothing will be shown during the wait time.


4) Record response as (text) for No Go

Setting (text): Type a name which will be used to record a 'No-Go' response.

Default = nogo; When the participant inhibits responding during a trial, the response will be recorded in the 'Response' column of your metrics as 'nogo'

For example, if you wish to mark your participants 'No-Go' response as correct for a particular trial, then in this instance you would use 'nogo' as your correct answer value in your 'ANSWER' Column for the trial in your spreadsheet.
Check out the examples and tutorials below to see this in action!


5) If (1 or 0) complete full image display and wait time after user input

Setting (1 or 0): Type 1 to turn setting on, Type 0 to turn setting off.

Default = 1 (on); A users response will not instantly end the trial, instead the image durations are honoured in full.
i.e. Regardless of whether the participant responds or not, the 'main image' and 'wait image' (Settings 1 & 2) will be shown for their full durations.

If set to 0; then a users reponse will instantly end the trial and they will be advanced to the next screen within your task.

Click to view an Example of a Task which makes use of the Go/No-Go Zone.

Click to view an Classic Experiment about Inattention & Impulsivity in children during the Go/No-Go Task.

Go/No-Go (Audio) Zone


The Go/No-Go (Audio) Zone is specialised for implementing audio go/no-go style experimental paradigms. This specialised Zone allows you to present an audio stimuli, while allowing the recording of a 'NoGo' response or an 'inhibited' response as a named response .

The Go/No-Go (Audio) Zone differs from other response zones, which record all 'non-responses' as both 'incorrect' and 'timed-out'. Once the requisite times have elapsed and no other response has been detected, the Go/No-Go (Audio) Zone will record a 'No Go' response. You can use any Active Response Zone - e.g. response button or keyboard response - to detect the 'Go' response.

Unlike the standard Go/No-Go Zone, if you require all your trials to be the same length, you must ensure that your audio files are the same length before you upload them.

  • Edit the Zone Content to add your audio stimuli

You should upload your stimuli under the Stimuli Tab of your Task and use the full file name (including file type) when referencing your Audio file.
Supported audio file types: .mp3, .ogg.

Note: If you wish to use Image Stimuli instead of Audio stimuli you will need to use the Go/No-Go Zone.

  • Edit the Zone's Configuration Settings to set how the Go/No-Go (Audio) Zone should function.

The Go/No-Go (Audio) Zone is primarily used for implementing go/no-go experimental paradigms. However this Zone is also highly appilcable to Audial search and Stimulus-Response compatibility tasks.

Go/No-Go (Audio) Zone Icon:

Click Here To View An Image Example Of The Go/No-Go (Audio) Zone & Configuration Settings

In the example below, the Go/No-Go (Audio) Zone has been set up to show audio stimuli from the spreadsheet and has been linked to the Task spreadsheet column named 'AUDIO-go-no-go-STIMULI'. Therefore, the filenames for the audio files which will be used in this section are contained in the corresponding spreadsheet column called 'AUDIO-go-no-go-STIMULI'.

We have set up the Go/No-Go (Audio) Zone to record a 'No Go' response as 'nogo' (configuration setting-1). Lastly, we have specified in, configuration setting-2, that the screen should wait for the full length of the audio file contained in the Go/No-Go Zone, regardless of whether the participant responds or not during the Audio play-time.

Note: The Go/No-Go (Audio) Zone does not have a response option built-in. Instead we have choosen to use two Response Button (Text) Zones for the participants to submit their response.

Configuration Settings:

1) Record response as (text) for No Go

Setting (text): Type a name which will be used to record a 'No-Go' response.

Default = none; The participants No-Go response will not be recorded.

If set to any text value: When the participant inhibits responding during a trial, the response will be recorded in the 'Response' column of your metrics as your text.

For example, if you wish to mark your participants 'No-Go' response as correct for a particular trial, then in this instance you would use 'nogo' as your correct answer value in your 'ANSWER' Column for the trial in your spreadsheet.
Check out the image examples above for a demonstration of this set-up.


2) If (1 or 0) continue to end of audio stimuli after user input

Setting (1 or 0): Type 1 to turn setting on, Type 0 to turn setting off.

Default = 1 (on); A users response will not instantly end the trial, instead the audio file durations are honoured in full.
i.e. Regardless of whether the participant responds or not, the audio file stimuli will play to their full durations.

If set to 0; then a users reponse will instantly end the trial and they will be advanced to the next screen within your task.

Click to view an Example of a Sample Project which makes use of the Go/No-Go (Audio) Zone.

Click Painting


This is a special template that provides the ability to click on an image, placing a coloured dot at the click location. The (x,y) coordinates of the click within the image are recorded in the metrics for the screen. While this widget records a response from the user, the response is not marked as correct or incorrect.

The zone provides a single input for the image the participant is to mark with dots. It is important to note that the (x,y) coordinates take into account the scaling of the image. If the source image is larger than the available zone, Gorilla will automatically shrink (rescale) the image to fit the available area. The click coordinates recorded in the metrics take this rescaling into account and will represent the equivalent location on the source image.

Limit number of clicks to number

After the number of clicks specified the task will move on to the next screen. Only clicks on the click painting zone will be recorded.


Click colour (red, yellow, blue or green) string

The colour of the dots the participant creates.


Size of click (in pixels) number

The size of the dot to be placed at the click location. Note that the recorded (x,y) coordinates will always represent the centre of the dot.


Click to view a Demo of the Click Painting Zone.

Click to view a Example of the Click Painting Zone.

Reading Zone


The Reading Zone allows you to add a ---- to your screen, which can be used to show participants -----.

Unlike other Zones, the Progress Bar Zone must be set up using a Spreadsheet source.

  1. Edit the Zone content to select Spreadsheet as the source for the Progress Bar Zone.
  2. Enter a name for the corresponding spreadsheet column to be used with the Progress Bar Zone. e.g. 'Progress'

For every display you wish the progress bar to be presented on.

  1. Add a 1 in the Zones corresponding column. i.e. under the 'Progress' column add 1's to all displays you wish the progress bar to be present on.

The same progress bar can be used across multiple different displays, so long as all displays have the Progress Bar Zone on them and they are all set up to use the same spreadsheet column.
The displays need not be contiguous - they can be separated by break screens.

The Reading Zone is typically used to -------. If you have a particularly long task, or an experiment with many tasks. Progress bars can be a helpful way of letting participants know when a break period is going to occur, encouraging a participant to complete their current section or task.

Reading Zone Icon:

Click Here To View An Image Example Of The Reading Zone & Configuration Settings
In the example below, the Reading Zone has been set-up to (Zone Content). The (Setting-1) has also been set-up to.
Click Here To view the Metric Columns generated by a Reading Zone
The Reading Zone, 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.
Column Name Row Response Description
Response SWITCH This is the reaction time (in ms) at which the participant pressed the Switch Button.
Response SWITCH ELAPSED This is the total time (in ms) that the participant has spent on the task before pressing the Switch button.

Download an Example

Configuration Settings:

1) Progress bar colour (blue, grey, green, red) (colour)

Setting (colour): Type one of the 4 colours (blue, grey, green, red) you wish for your progress bar to appear.

Default = blue; the progress bar colour will be blue.

If this setting is also set to be controlled by a spreadsheet, colour can be varied between displays.

Click to view a Demo of the Reading Zone.

Click to view an Example of a Sample Project which makes use of the Reading Zone.

Keyboard Hold / Release Zone


The Keyboard Hold/Release Zone is an advanced response zone which allows you to record advanced key responses, such as when a key is held down for a duration (Hold) or when a held key is released (Release).

How it works:

The Keyboard Hold/Release Zone is a unique zone which differes from standard zones in 4 ways:

  1. The Zone will need to be set up across multiple screens.
  2. You can only use 1 Keyboard Hold/Release Zone on a screen.
  3. How the Zone works changes depending upon which operation mode is chosen.
  4. It does not use the active response settings associated with the other standard keyboard response zones.

The Keyboard Hold/Release Zone works by listening for the specified key 'event' once each screen. Once the event (A key held or released) has occured the participant will be advanced to the next screen.


Setting up the Hold Release Zone:
The exact set up of the Keyboard Hold/Release Zone will differ depending upon which operation mode you are using. The differences are highlighted in step 1 below.

  1. Firstly, edit Configuration Setting-1 to set the operation mode to either Hold or Release. You must choose one of the two operation modes for the Keyboard Hold/Release Zone to work. The Zone will function differently depending on which mode is choosen.

In Hold mode the Zone will listen for the specified key press (configuration setting-2) and only advance the screen when the hold duration time has elapsed (configuration setting-4).
When you wish to listen for 'held' key events you will need to configure all 4 settings on your Keyboard Hold/Release Zone, in order for the zone to function as required.

In Release mode the Zone will listen for the release of the specified key press (configuration setting-2) and will the screen as soon as the specified key is released.
When you wish to listen for 'released' key events you will only need to configure the first 3 settings on your Keyboard Hold/Release Zone, in order for the zone to function as required.

  1. Secondly, you will need at least 2 screens in your task, in order to set up the Keyboard Hold/Release Zone correctly. Typically, you will want to listen for the key press on one screen (Hold mode) and then listen for the release of the same key on a second screen (Release mode).

In order to achieve this simply set the Keyboard Hold/Release Zone on your first screen to Hold mode by typing Hold in setting-1 of the zones configuration settings. On a later screen (either within the same display or a separate display) set up your Keyboard Hold/Release Zone to listen for a 'Release' event: Type Release into setting-1 of the zones configuration settings.

Note: You cannot listen for both a held key and a released key on the same screen. Each task screen can only be set up with one functioing Keyboard Hold/Release Zone per screen.


Use Case:
The typical use case for a Keyboard Hold/Release Zone is when you wish to record advanced keyboard responses that are not just single key presses offered by the ordinary Keyboard Response Zones.

Keyboard Hold/Release Zone Icon:

Configuration Settings:

1) Use (Hold or Release) mode (either 'Hold' or 'Release')

Setting (Hold or Release): Type either 'Hold' or 'Release' to choose the operation mode for the Zone.

Default = none; The Zone is not set to any mode and will not listen for key presses or key releases.

If set to Hold; the Zone will listen for 'Held' key presses of the key specified in setting-2.

If set to Release; the Zone will lisen for 'Released' key presses of the key specified in setting-2.


2)

If (key) is pressed

Setting (key): Type the key mapping to be used for the response.

Default = None; No key is mapped to the Response Zone.

To map a key to a response: Enter the letter of the key you wish to detect (e.g. a for the A key).
Alternatively, use any of the following special key mappings:

  • space for the Space Bar key
  • left for the Left Arrow key
  • right for the Right Arrow key
  • up for the Up Arrow key
  • down for the Down Arrow key
  • enter for the enter key
  • backspace for the backspace key
  • delete for the delete key

3) Record response as (text)

Setting (text): Type the name-label you wish to be assigned as the recorded response identifier.

Default = none; the reaction time response will be recorded but there will be no response identifier recorded.

If set this name-label is what will be recorded in the metrics, if this key is pressed/release as a response by a participant.


4) Hold button for (number) ms before advancing

Setting (number): Type a numerical value for the amount of time, in milliseconds (ms), the key should be held for before the screen will advance.

Default = 0; The screen will advance immediately upon the required key being pressed. This will act like the regular keyboard response zone.

If set, the key must be held for the specified length of time, in milliseconds (ms), before the screen will advance. If the participant releases the key before the required time has elapsed an alert message will be displayed asking the participant to keep the key pressed.

Click to view an Example of the Keyboard Hold/Release Zone in a Task.

Click to view an Example of an Experiment which contains the Keyboard Hold/Release Zone Task game.

Progress Bar Zone


The Progress Bar Zone allows you to add a progress bar to your screen, which can be used to show participants how far they are through a task. For each trial containing a progress bar that a participant finishes the progress bar will fill up, indicating to the participant how far through your trials they have progressed.

How it works: Every row, i.e. 'trial', in your spreadsheet which has a 1 within the 'ShowProgressBar' column counts towards the total 'length' of your Progress bar. On completing a row of your spreadsheet, i.e. a display, then the progress bar will visually incrementally increase. This means that the bar will progress between displays, or between repeated displays, but not within displays (i.e. not between screens of the same display).

Unlike other Zones, the Progress Bar Zone must be set up using a Spreadsheet source.

  1. By default the source for the Zone content is set to Spreadsheet; this source type should not be changed.
  2. The default name for the corresponding spreadsheet column to be used with the Progress Bar Zone is 'ShowProgressBar'

Note: If you wish you can change the default name of 'ShowProgressBar' by clicking on the Zone and editing the Zone content. If you choose to do this be sure to also update your corresponding column heading in your Task Spreadsheet.

For every display you wish the progress bar to be presented on:

  1. Add a 1 in the Zones corresponding column. i.e. under the 'ShowProgressBar' column add 1's to all displays you wish the progress bar to be present on.

The same progress bar can be used across multiple different displays, so long as all displays have the Progress Bar Zone on them and they are all set up to use the same spreadsheet column name.
The displays need not be contiguous - they can be separated by break screens.

The Progress Bar Zone is typically used to give the participant a sense of how long a task will take them. If you have a particularly long task, or an experiment with many tasks then Progress bars can be a helpful way of letting participants know when a break period is going to occur. This could encourage a participant to complete their current section or task.

Progress Bar Zone Icon:

Click Here To View An Image Example Of The Progress Bar Zone & Configuration Settings
In the example below, the Progress Bar Zone has been set-up to correspond with the spreadsheet column named 'Progress' (Zone content). The Progress Bar colour (Setting-1) has also been set-up to correspond with a spreadsheet column named 'ProgressColour'. This means that the spreadsheet controls both when the progress bar is displayed on a screen and the colour it appears as on each screen.

Configuration Settings:

1) Progress bar colour (blue, grey, green, red) (colour)

Setting (colour): Type one of the 4 colours (blue, grey, green, red) you wish for your progress bar to appear.

Default = blue; the progress bar colour will be blue.

If this setting is also set to be controlled by a spreadsheet, colour can be varied between displays.

Click to view a Demo of the Progress Bar Zone.

Click to view an Example of a Sample Project which makes use of the Progress Bar Zone.

Feedback (Accuracy) Zone


The Feedback (Accuracy) Zone allows you to provide the participant with visual feedback about their accuracy based on their response.

The Feedback (Accuracy) Zone must be used in conjunction with an Active Response Zone. This means:

  1. The Feedback (Accuracy) Zone must be used on a screen which also has at least one Active Response Zone.
  2. You must have configured setting-1 of the 'Correct Answer' Active Response Configuration Settings.

By default the feedback is displayed as a green tick (on a correct answer) and a red cross (on an incorrect answer). You can change these default images by editing the Zone content for the two sections of the Feedback (Accuracy) Zone:

  • (Optional) Left Side: Edit the Zone Content to set an alternative image for positive (correct answer) feedback: Upload the image under the Stimuli page and then enter the full file name (e.g. image.png) as the zone content.
  • (Optional) Right Side: Edit the Zone Content to set an alternative image for negative (incorrect answer) feedback: Upload the image under the Stimuli page and then enter the full file name (e.g. image.png) as the zone content.

Supported Image types: .png, .jpg, .jpeg, and .gif

To control which type of feedback is displayed, feedback duration, and to change feedback 'honesty':

  • Edit the Feedback (Accuracy) Zone configuration settings.

The Feedback (Accuracy) Zone is typically used when you wish to present your participants with instantaneous visual feedback about the accuracy of their answers or responses to your question.
Note: You do not need to use a feedback zone to provide participants with their score; instead use the 'Embedded data settings' of the Active Response Zone configuration settings.

Feedback (Accuracy) Zone Icon:
Feedback (Accuracy) Zone Icon

Click Here To View An Image Example Of The Feedback (Accuracy) Zone & Configuration Settings
In the example below, the Feedback (Accuracy) Zone has been set-up to show feedback for 500ms (Setting 3) on both correct and incorrect responses (Setting 1 & 2). Feedback is 100% honest as Feedback honesty settings are turned off (Setting 4 & 5). In this example a text response button called 'A' is set up to be the correct answer (Active Response config setting 1). If the participant selects this as their response, then the default 'green tick' feedback will be displayed. Any other response selected by the participant will result in the default 'red cross' feedback being displayed.
Feedback (Accuracy) Zone and configuration settings Image

Configuration Settings:

1) If (1 or 0) show feedback when response is correct

Setting (1 or 0): Type 1 to turn setting on, Type 0 to turn setting off.

Default = 'Off' (0); No feedback is displayed.

If set to 1, turns on feedback: displays feedback when a correct answer is selected by the participant.

Note: You must have set up a correct answer in the 'Active Response Correct Answer' configuration settings for this to work.


2) If 1 or 0 show feedback when response is incorrect

Setting (1 or 0): Type 1 to turn setting on, Type 0 to turn setting off.

Default = 'Off' (0). No feedback is displayed.

If set to 1, turns on feedback: displays feedback when an incorrect answer is selected by the participant.

Note: You must have set up a correct answer in the 'Active Response Correct Answer' configuration settings for this to work.


3) Show feedback for (number) milliseconds (Mandatory)

Setting (number): Type a numerical value for the amount of time, in milliseconds (ms),
                  you wish feedback to be shown for.

Default = 0; No feedback will be displayed.

When set, feedback will be displayed for the specified amount of time once a response is selected by the participant.

If the screen would normally advance once the response has been entered*; there will be a delay of this amount of time for the feedback to be shown before the screen is advanced. *i.e. Active Response Setting 'Sudden death' is turned on (set to 1) If the response would not normally advance the screen: the feedback will be shown for this length of time and then hidden again.


4) Percentage honesty in feedback when a response is correct (number)%

Setting (number): Type a numerical value between 0 and 100 to set the percentage
                  of honesty for 'correct' answer feedback.

Default = 100; feedback is always (100%) honest. If the participant gives a correct answer, then the correct answer feedback will be presented 100% of the time.

If set to any value between 0 and 100 then the percentage of 'correct answer' feedback presented, upon a correct answer being recorded, will be honest the specified % of time.

Example 1:
If set to 90% then, on average, 10% of the time the feedback given for a correct answer will actually show feedback for an incorrect answer.

Example 2:
If set to 0% then, 100% of the time the feedback given for a correct answer will actually show feedback for an incorrect answer. i.e. the participant will always (100% of the time) be shown 'incorrect answer' feedback for a 'correct answer' response.

In the metrics: A correct response will always be recorded as correct. The column 'dishonest' will have a 1 if the participant received dishonest feedback - and a 0 if the participant received honest feedback.


5) Percentage honesty in feedback when response is incorrect (number)%

Setting (number): Type a numerical value between 0 and 100 to set the percentage
                  of honesty for 'incorrect' answer feedback.

Default = 100; feedback is always (100%) honest. If the participant gives an incorrect answer, then the incorrect answer feedback will be presented 100% of the time.

If set to any value between 0 and 100 then the percentage of 'incorrect answer' feedback presented, upon a incorrect answer being recorded, will be honest the specified % of time.

Example 1:
If set to 63% then, on average, 37% of the time the feedback given for an incorrect answer will actually show feedback for a correct answer.

Example 2:
If set to 0% then, 100% of the time the feedback given for an incorrect answer will actually show feedback for a correct answer. i.e. the participant will always (100% of the time) be shown 'correct answer' feedback for an 'incorrect answer' response.

In the metrics: A incorrect response will always be recorded as incorrect. The column 'dishonest' will have a 1 if the participant received dishonest feedback - and a 0 if the participant received honest feedback.

Click to view an Example of a Sample Task which makes use of the Feedback (Accuracy) Zone.

Feedback Audio (Accuracy) Zone


The Feedback Audio (Accuracy) Zone allows you to provide the participant with audio feedback about the accuracy of their response.

The Feedback Audio (Accuracy) Zone must be used in conjunction with an Active Response Zone. This means:

  1. The Feedback Audio (Accuracy) Zone must be used on a screen which also has at least one Active Response Zone.
  2. You must have configured setting-1 of the 'Correct Answer' Active Response Configuration Settings.

Edit the Zone content for the two sections of the Feedback Audio (Accuracy) Zone to select the audio to be played as feedback:
Note: Unlike the 'Feedback (Accuracy) Zone' this zone has no default audio feedback stimuli instead you must upload your own audio sound files to use within this zone.

  • (Mandatory) Left Side: Edit the Zone Content to set an audio stimuli for positive (correct answer) feedback: Upload the audio file under the Stimuli page and then enter the full file name (e.g. audio1.mp3) as the zone content.
  • (Mandatory) Right Side: Edit the Zone Content to set an audio stimuli for negative (incorrect answer) feedback: Upload the audio under the Stimuli page and then enter the full file name (e.g. audio2.mp3) as the zone content.

To control which type of audio feedback is displayed and change feedback 'honesty':

  • Edit the Feedback Audio (Accuracy) Zone configuration settings.

The Feedback Audio (Accuracy) Zone is typically used when you wish to present your participants with instantaneous audio feedback about the accuracy of their answers or responses to your question.
Note: You do not need to use a feedback zone to provide participants with their score; instead use the 'Embedded data settings' of the Active Response Zone configuration settings.

Feedback Audio (Accuracy) Zone Icon:
Feedback (Accuracy) Zone Icon

Click Here To View An Image Example Of The Feedback Audio (Accuracy) Zone & Configuration Settings
In the example below, the Feedback Audio (Accuracy) Zone has been set-up to give feedback on both correct and incorrect responses (Setting 1 & 2). Audio files have been uploaded to the Stimuli page and the full file path is written in the Feedback Audio (Accuracy) zone as content for both 'correct' and 'incorrect' feedback options. Feedback is 100% honest as Feedback honesty settings are turned off (Setting 4 & 5). In this example a text response button called 'A' is set up to be the correct answer (Active Response config setting 1). If the participant selects this as their response, then the audio sound file 'YES.mp3' will play. Any other response selected by the participant will result in the audio sound file 'NO.mp3' being played.
Feedback Audio (Accuracy) Zone and configuration settings Image

Configuration Settings:

1) If (1 or 0) give feedback when response is correct

Setting (1 or 0): Type 1 to turn setting on, Type 0 to turn setting off.

Default = 'Off' (0); No feedback is displayed.

If set to 1, turns on feedback: displays feedback when a correct answer is selected by the participant.

Note: You must have set up a correct answer in the 'Active Response Correct Answer' configuration settings for this to work.


2) If 1 or 0 give feedback when response is incorrect

Setting (1 or 0): Type 1 to turn setting on, Type 0 to turn setting off.

Default = 'Off' (0). No feedback is displayed.

If set to 1, turns on feedback: displays feedback when an incorrect answer is selected by the participant.

Note: You must have set up a correct answer in the 'Active Response Correct Answer' configuration settings for this to work.


3) Delay of (number) ms after audio feedback ends

Setting (number): Type a numerical value for the amount of time, in milliseconds (ms),
                  you wish to delay after the audio feedback has ended.

Default = 0; No delay after feedback has finished playing, if the screen would advance it does so immediately.

When set if the screen would normally advance once the response has been entered*; there will be a delay of this amount of time, after the audio feedback has finished playing, before the screen is advanced.
*i.e. Active Response Setting 'Sudden death' is turned on (set to 1)


4) Percentage honesty in feedback when a response is correct (number)%

Setting (number): Type a numerical value between 0 and 100 to set the percentage
                  of honesty for 'correct' answer feedback.

Default = 100; feedback is always (100%) honest. If the participant gives a correct answer, then the correct answer feedback will be presented 100% of the time.

If set to any value between 0 and 100 then the percentage of 'correct answer' feedback presented, upon a correct answer being recorded, will be honest the specified % of time.

Example 1:
If set to 90% then, on average, 10% of the time the feedback given for a correct answer will actually give feedback for an incorrect answer.

Example 2:
If set to 0% then, 100% of the time the feedback given for a correct answer will actually give feedback for an incorrect answer. i.e. the participant will always (100% of the time) be presented 'incorrect answer' feedback for a 'correct answer' response.

In the metrics: A correct response will always be recorded as correct. The column 'dishonest' will have a 1 if the participant received dishonest feedback - and a 0 if the participant received honest feedback.


5) Percentage honesty in feedback when response is incorrect (number)%

Setting (number): Type a numerical value between 0 and 100 to set the percentage
                  of honesty for 'incorrect' answer feedback.

Default = 100; feedback is always (100%) honest. If the participant gives an incorrect answer, then the incorrect answer feedback will be presented 100% of the time.

If set to any value between 0 and 100 then the percentage of 'incorrect answer' feedback presented, upon a incorrect answer being recorded, will be honest the specified % of time.

Example 1:
If set to 63% then, on average, 37% of the time the feedback given for an incorrect answer will actually give feedback for a correct answer.

Example 2:
If set to 0% then, 100% of the time the feedback given for an incorrect answer will actually give feedback for a correct answer. i.e. the participant will always (100% of the time) be presented 'correct answer' feedback for an 'incorrect answer' response.

In the metrics: A incorrect response will always be recorded as incorrect. The column 'dishonest' will have a 1 if the participant received dishonest feedback - and a 0 if the participant received honest feedback.

Click to view a Demo of the Feedback Audio (Accuracy) Zone.

Feedback (Speed) Zone


The Feedback (Speed) Zone allows you to provide the participant with visual feedback at a set time, if they have not yet given a correct response.

  • (Mandatory) Edit the Zone content to set the text of the feedback you wish to be displayed.
  • (Mandatory) Edit the Zone's Configuration settings to set how the Feedback Zone functions.

Although it is not mandatory, the Feedback (Speed) Zone is typically used in conjunction with an Active Response Zone.
This means:

  • The Feedback (Speed) Zone must be used on a screen which also has at least one Active Response Zone.
  • You must have configured setting-1 of the 'Correct Answer' Active Response Configuration Settings.

The Feedback (Speed) Zone is typically used to present feedback to the participant about the speed of their response - often to encourage them to answer as quickly as possible.

Alternatively, multiple Feedback (Speed) zones can be used to display messages to the participant at set times. e.g. as distractors while studying a stimuli presentation (video/text/image) or else as hints to help the participant answer a question.

Lastly, the Feedback (Speed) Zone, can be used to automatically advance a participant to the next screen at a set time if no correct answer has been given. This will therefore replace the need for a Timelimit (Screen) Zone in this scenario.

Feedback (Speed) Zone Icon:

Click Here To View An Image Example Of The Feedback (Speed) Zone & Configuration Settings

In the example below, there are two Feedback (Speed) Zones.

The 1st Feedback (Speed) Zone [Dark-Green] is set up to display the message 'Hurry - only 1 second left' (Zone content) for 1s (1000ms) (Setting-2), if the participant has not responded before 2s (2000ms) (Setting-1).

The 2nd Feedback (Speed) Zone [Light-Green] is set up to display the message 'Too slow! Better luck next time.' for a duration of 1s (Setting-2) after 3s has passed (Setting-1). The 2nd Feedback (Speed) Zone has additionally been set up to auto-advance the participant to the next screen (Setting-3) if the participant has not given a correct response before this point.

Configuration Settings:

1) If no response after (number) milliseconds, show feedback

Setting (number): Type a numerical value for the time (in miliseconds) at which feedback will be displayed if the participant has not given a correct response.

Default = 0; Feedback will not be displayed.

If set, this represents the amount of time to allow participant to respond before showing the feedback text.


2) Display feedback for (number) milliseconds (Mandatory)

Setting (number): Type a numerical value for the amount of time (in miliseconds) the feedback should be displayed for.

Default = 0; Feedback will not be displayed.

If set, this represents the duration for which a participant will be shown the feedback text.


3) If (1 or 0) end the current trial without a response

Setting (1 or 0): Type 1 to turn setting on, Type 0 to turn setting off.

Default = 0 (off); Feedback (Speed) Zone will not auto-advance the participant to the next screen.

If set to 1, the screen will automatically advance once the feedback text has finished being displayed.

Click to view an Example of a Sample Task which makes use of the Feedback (Speed) Zone.

Response Window Zone


The Response Window Zone allows you to add a ---- to your screen, which can be used to show participants -----.

Unlike other Zones, the Progress Bar Zone must be set up using a Spreadsheet source.

  1. Edit the Zone content to select Spreadsheet as the source for the Progress Bar Zone.
  2. Enter a name for the corresponding spreadsheet column to be used with the Progress Bar Zone. e.g. 'Progress'

For every display you wish the progress bar to be presented on.

  1. Add a 1 in the Zones corresponding column. i.e. under the 'Progress' column add 1's to all displays you wish the progress bar to be present on.

The same progress bar can be used across multiple different displays, so long as all displays have the Progress Bar Zone on them and they are all set up to use the same spreadsheet column.
The displays need not be contiguous - they can be separated by break screens.

The Response Window Zone is typically used to -------. If you have a particularly long task, or an experiment with many tasks. Progress bars can be a helpful way of letting participants know when a break period is going to occur, encouraging a participant to complete their current section or task.

Response Window Zone Icon:

Click Here To View An Image Example Of The Response Window Zone & Configuration Settings
In the example below, the Response Window Zone has been set-up to (Zone Content). The (Setting-1) has also been set-up to.
Click Here To view the Metric Columns generated by a Response Window Zone
The Response Window Zone, 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.
Column Name Row Response Description
Response SWITCH This is the reaction time (in ms) at which the participant pressed the Switch Button.
Response SWITCH ELAPSED This is the total time (in ms) that the participant has spent on the task before pressing the Switch button.

Download an Example

Configuration Settings:

1) Progress bar colour (blue, grey, green, red) (colour)

Setting (colour): Type one of the 4 colours (blue, grey, green, red) you wish for your progress bar to appear.

Default = blue; the progress bar colour will be blue.

If this setting is also set to be controlled by a spreadsheet, colour can be varied between displays.

Click to view a Demo of the Response Window Zone.

Click to view an Example of a Sample Project which makes use of the Response Window Zone.

Fixation Zone


The Fixation Zone allows you to add a single fixation cross to your screen.

  • [Mandatory] Edit the configuration settings to set the length of time (in ms) that the fixation cross should be displayed.

The fixation cross will be centred in the Fixation Zone's area.

Use the Fixation Zone to present a fixation cross to your participant between trials. The Fixation Zone is typically used when you want your participant to focus during a brief pause between stimuli displays or questions.

Fixation Zone Icon:

Click Here To View An Image Example Of The Fixation Zone & Configuration Settings
In the example below, the Fixation Zone is set up to display the fixation cross for a total of 300ms (Setting-1). A pause time of 100ms has been set (Setting-2). This will result in a total screen display time of 500ms; 100ms wait before cross, 300ms show cross, 100ms wait after cross. Setting-1 is mandatory but Setting-2 is optional.

Configuration Settings:

1) Show fixation cross for (number) milliseconds [Mandatory]

Setting (number): Type a value for the number of milliseconds (ms).

Amount of time the fixation cross is displayed for


2) Before and after showing the fixation cross, pause for (number) milliseconds

Setting (number): Type a value for the number of milliseconds (ms).

Default = 0; The fixation cross is shown immediatley. There is no pause time before or after showing the fixation cross. Once the fixation time (setting-1) is reached the next screen appears immediately.

If set, a pause time in milliseconds will be applied to the fixation zone. The pause time will appear as a blank screen and will be displayed before and after the fixation cross.

Click to view an Example of a Sample Project which makes use of the Fixation Zone.

Timelimit (Screen) Zone


The Timelimit (Screen) Zone allows you to add a timelimit to your screen which will autoadvance a participant to the next screen in your display after a set amount of time.

The Timelimit (Screen) Zone, by default, does not have any visible display on a screen. However, you can edit configuration setting-2 to if you wish to display a visual countdown to your participant.

The Timelimit (Screen) Zone is typically used to limit the amount of time a stimuli (e.g. text or image) is shown for. It can also be used instead of a fixation zone; when you wish to present a break between trials as a blank screen. Alternatively, it can be used alongside Response zones to limit the time a participant has to answer a question.

Timelimit (Screen) Zone Icon:

Click Here To View An Image Example Of The Timelimit (Screen) Zone & Configuration Settings
In the example below, the Timelimit (Screen) Zone is set to last 15s (15000ms) (setting-1). The countdown clock is set to be displayed for the full length of the timelimit (setting-2). A participant will therefore see a countdown for the full 15s of the timelimit before being automatically advanced to the next screen.

Configuration Settings:

1) Automatically advance to the next screen after (number) milliseconds [Mandatory]

Setting (number): Type a time, as a number of milliseconds (ms), for the total duration of the time-limit.

The participant will be automatically advanced to the next screen after the set amount of time has elapsed.


2) Display countdown for the last (number) milliseconds

Setting (number): Type a time, as a number of milliseconds (ms), for which a countdown clock is displayed.

Default = 0; no countdown clock is displayed.

If set to anything >0; Displays a clock and pulsing countdown for the specified amount of remaining time (to the nearest second).

Note: This time must be equal to, or less than, the overall screen timelimit set in setting-1.

Click to view an Example of a Sample Project which makes use of the Timelimit (Screen) Zone.

Timelimit (Section) Zone


The Timelimit (Section) Zone allows you to add an overall timelimit to a block of trials or a whole task.

How it works:
Every row, i.e. 'trial', in your spreadsheet which has a 1 within the 'TimedSection' column will be included in your time-limited section. The timelimit begins when the participant reaches the screen containing the Timelimit Zone.

Once the duration of the timelimit has elapsed, and the current screen has been finished, the participant will progress to the next display in the spreadsheet outside the timelimited section. i.e. to the next row which does not have a '1' under the 'TimedSection' column.

The time limit is only checked each time the participant reaches a screen which contains the Timelimit (Section) Zone (such as the same screen in a run of multiple trials). If the time limit duration has elapsed then only when the participant reaches and completes a trial screen containing a Timelimit (Section) Zone will the participant be prevented from continuing with the Trials within the time-limited section.

Unlike most other Zones, the Timelimit (Section) Zone must be set up using a Spreadsheet source.

  1. [Mandatory] By default the source for the Zone content is set to Spreadsheet; this source type should not be changed.
  2. [Mandatory] The default name for the corresponding spreadsheet column to be used for the Timelimit (Section) Zone is 'TimedSection'.

Note: If you wish you can change the default name of 'TimedSection' by clicking on the Zone and editing the Zone content. If you choose to do this be sure to also update your corresponding column heading in your Task Spreadsheet.

For every display you wish to be included in the timelimited section:

  1. [Mandatory] In your task spreadsheet add a 1 in the corresponding zones's column for that Display.
    i.e. under the 'TimedSection' column add 1's to all displays you wish to be included in the time-limited section.

The same Timelimit (section) Zone can be used across multiple different displays but these displays must be contiguous and all have the Timelimit (Section) Zone on them set up identically; i.e. to use the same spreadsheet column. Thus, these displays can be separated by break screens only if the break screen is also included in the timelimit.
Note: Displays in the Timelimited Section can not also be part of a block-randomisation (randomise_blocks). However, you can still use trial-randomisation (randomise_trials).

  1. [Mandatory] Edit the Zones Settings to set the duration of the time limit in milliseconds
    i.e. set the total amount of time you wish participants to be able to spend on the section. By default this is set to 30,000ms (30s).

Once the duration of the timelimit has elapsed, and the current screen has been finished, the participant will progress to the next display in the spreadsheet outside the timelimited section. i.e. to the next row which does not have a '1' under the 'TimedSection' column.

The Timelimit (Section) Zone is typically used to limit the maximum about of time a participant can spend on a task or set of trials. It is also useful in cases where you are testing to see how many trials a participant can perform in a given amount of time.

Timelimit (Section) Zone Icon:

Click Here To View An Image Example Of The Timelimit (Section) Zone & Configuration Settings
In the example below, the Timelimit (Section) Zone has been set-up to correspond with the spreadsheet column named 'TimedSection' (Zone content) with a total time limit of 20s (Setting-1). This means that the spreadsheet controls which trials are part of the timed section. When the time-limit (Setting-1) is reached the participant will be shown the first display which is not part of this timed section.

Configuration Settings:

1) Automatically advance to the next section after (number) milliseconds [Mandatory]

Setting (number): Type a time, in milliseconds (ms), for the total duration of the time-limit.

Default = 30000; The maximum amount of time a participant can spend on the section is 30s (30,000 ms).

Set the maximum amount of time a participant can spend on the section. Once the duration of the timelimit has elapsed, and the current screen has been finished, the participant will progress to the next display in the spreadsheet outside the timelimited section.

Click to view a Demo of the Timelimit (section) Zone.

Click to view an Example of a Task which makes use of the Timelimit (Section) Zone.

Go To Zone


Normally, a task will always advance on to the next screen in a display. The Go To Zone allows you to define a specific screen (within the current display), to move a participant to, following the completion of the current screen.

The Go To Zone works in the same way as the 'advance to screen' setting of the 'Correct Answer' Active Responses Settings and is usually used in conjunction with the other 'Advanced branching Settings'. Allowing you to add this same functionality to screens without an Active Response Zone.

The Go To Zone is typically used when you wish to implement within-task branching. This is often used to show different screens to participants depending upon how the participant responds to a question. e.g. to advance the participant to specific response feedback screens for correct or incorrect answers.

Go To Zone Icon:

Click Here To View An Image Example Of The Go To Zone & Configuration Settings
In the example below, the Go To Zone has been set-up to advance the participant to the screen named 'finish' once the time-limit on the Timelimit (Screen) Zone has elapsed.

Configuration Settings:

1) When the screen is complete, advance to screen (text)

Setting (text): Type a screen name from the current display.

Default = None; Screen will advance as normal to the next screen in the display.

Set a screen name (within the same display). When the current screen is finished, Gorilla will then advance to the named screen within your current display.

Click to view a Demo of the Go To Zone.

Click to view an Example of a Sample Project which makes use of the Go To Zone.

Early Exit Zone


The Early Exit Zone allows you to break the normal flow of the Task spreadsheet by adding a button to the screen which when pressed will immediately end the current Task.

How it works:
Normally, a task will always advance on to the display in the next row of the spreadsheet. Going through each Row of the spreadsheet, one-by-one, in order from top to bottom, until the task is completed.

The Early Exit Zone overwrites the normal flow of your Task spreadsheet. When the participant presses the Early Exit button the Task ends immediately. The participant will not see any further part of this Task. Instead the participant will advance to the next Node in your Experiment Tree.

Further to this, when a participant clicks the Early Exit Zone a piece of embedded data with the default name earlyExit is generated. This embedded data can then be used in your experiment Tree Branch Nodes to branch participants who have chosen to exit your task early via the early exit button.

  • Edit the Zone configuration settings to customise the name of the embedded data.

Use Case:
The typical use case for a Early Exit Zone is to offer participants an option to withdraw from your experiment at any time.
Further to this, the embedded data can be used to easily branch participants who withdraw to a Reject Node.

Other common use cases for the Early Exit Zone are in thresholding tasks and grit/perserverence studies. By making use of the embedded data setting (with source set to Spreadsheet) participants can be branched to tasks of different difficulty.

Explore the linked examples at the bottom of this page for a demonstration of experimental designs which make use of the Early Exit Zone embedded data.

Early Exit Zone Icon:

Configuration Settings:

1) Store an early exit as Embedded Data called (text)

Setting (text): Type a key-name for the embedded data.

Default = earlyExit; The key-name given to the embedded data will be earlyExit.

If the text is changed from the default then your new text will become the key-name of the embedded data.


Embedded data & the Branch Node:
When using the embedded data from the Early Exit Zone within a Branch Node. Set the Propertly field to be the key-name (e.g. earlyExit) and the Value field to be True. This will allow you to branch any participant who has clicked the early exit button within your task.

Note: The early exit zone will only generate embedded data if a participant has clicked the early exit button during the task. If you also wish to branch participants who have not clicked an Early Exit button then simply create a branch with both branch node fields left empty and set this as your default branch. This will allow you to separate out participants who clicked the early exit button from those who completed the task.

See the linked examples below for a demonstration of experimental set ups using the Early Exit Zone embedded data.

Click to view an Example of using the Early Exit Zone in a Task to allow participants to withdraw at any time.

Click to view an Example of an Experiment where the Early Exit Zone embedded data is used to branch participants who withdraw during the task.

Click to view an Example of using the Early Exit Zone to determine performance outcomes in a Thresholding Task.

Click to view an Example of an Experiment where the Early Exit Zone embedded data is used to branch participants depending upon their performance in the Thresholding Task.

Jump To Row Zone


The Jump To Row Zone allows you to break the normal flow of the Task spreadsheet by defining a specific row number from your spreadsheet you wish your participant to move on to. It should be used in conjunction with in-task Branching.

How it works:
Normally, a task will always advance on to the display in the next row of the spreadsheet. Going through each Row of the spreadsheet, one-by-one, in order from top to bottom.

The Jump To Row Zone overwrites the normal flow of your Task spreadsheet. When the participant reaches a screen containing a Jump To Row Zone, instead of progressing to the next screen in the current display - or continuing on to the next row in your spreadsheet - the participant will jump to the row number you specify and be shown the display listed in this row.

The Jump To Row Zone will activate once the current screen (containing the Jump To Row Zone) has been completed.

Caution

The Jump To Row Zone overwrites the normal order that a participant will go through your spreadsheet. If the Jump To Row Zone is set up incorrectly, it is possible to create infinite loops in your task, which will mean participants will not be able to reach the end of your task.

This can be avoided by always using the Jump to Row Zone in conjunction with the Active Response: 'Advanced Branching Settings'. Ensure your task is working corretly and as expected by previewing your task and piloting before launch.

Use Case:
The typical use case for a Jump to Row Zone is when you wish to grant participants the option to repeat a sub-section of trials within a task. Such as repeating the practice trials of a task.

Another use case for the Jump to Row Zone is to be able skip sections of your task spreadsheet dependant on participants answers. This allows you to skip sections of your task you don't wish participants to see if they have given a particular response.

Jump To Row Zone Icon:

Configuration Settings:

1) When this screen is complete, jump to spreadsheet row (number)

Setting (number): Type a number of a row in your task spreadsheet.

Default = none; The task will continue as normal and will not jump to any row in the spreadsheet.

If set to anything >0; On completion of the screen the task will immediately jump to this row number.

The participant will be presented with the display contained in this row and will continue through the task spreadsheet row by row from this point onward (unless a Jump to Row Zone is met).

Note: The row number must exist in your task spreadsheet for the Jump to Row Zone to be able to function.
Check the Spreadsheet Tab of your Task to check the row number you wish to reference.

Click to view an Example which makes use of the Jump To Row Zone to allow participants to repeat practice trials within a Task.

Switch Zone


The Switch Zone adds a 'Switch' button to the task screen which allows the participant to switch to the corresponding Switch Node Task in your experiment.

  • Edit the Zone Content to edit the label of the button. By default this is 'Switch'.

Note:
The Switch Zone is a special Zone which 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 Zone in both of the Tasks tethered to your Switch Node if you wish your participants to be able to switch freely between the tasks.
You must include a Switch Zone on every Screen of your Tasks that you wish your participant to be able to switch from.

The Switch Zone is only used when using the Switch Node within your Experiment Tree.
You can find out more about the Switch Node here.

Switch Zone Icon:
Click Here To View An Image Example Of The Switch Zone & Configuration Settings
In the example below, you can see that there are no configuration settings for the Switch Zone. The Switch button label has been changed from the default of 'Switch' to 'Switch to Task 2!' by editing the Zone content.
This image example shows how the Switch button appears disabled when Previewing it as a Task. Notice that the switch button will only function when previewing from the experiment itself (i.e. when the task is tethered to another task via the Switch Node).
Click Here To view the Metric Columns generated by a Switch Zone & Switch Node
The Switch Zone, 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.
Column Name Row Response Description
Response SWITCH This is the reaction time (in ms) at which the participant pressed the Switch Button.
Response SWITCH ELAPSED This is the total time (in ms) that the participant has spent on the task before pressing the Switch button.

Download an Example

Configuration Settings:

-- No Settings --

Click to view a Demo of the Switch Zone and Switch Node.

Auto Advance


This functionality is deprecated and will not appear unless previously set in a task.

Please use the new Timelimit (screen) Zone!


Set a timelimit for the screen. When this timelimit expires the task will advance to the next screen.

Automatically advance to the next screen after number milliseconds

The task will automatically advance to the next screen after the set time.

Embedded YouTube Zone


This functionality is deprecated and replaced with the updated Embedded YouTube Zone.

Please use the new Embedded YouTube Zone!


The Embedded YouTube Zone allows you to present a single YouTube video on your screen.
You must first copy the link of the YouTube video you wish to Embed.
Then paste link into the Embedded YouTube Zone or relevant spreadsheet column.

For the link you can use any of the following:

  • The full URL of the YouTube video (https://youtube.com/watch?v=ABCDEF)
  • The Share link (https://youtu.be/ABCDEF)
  • Just the video ID (ABCDEF)

Use the Embedded YouTube Zone to contain the video media you wish to present. The Embedded YouTube Zone is typically used to present short YouTube video stimuli.

Embedded YouTube Zone Icon:

Configuration Settings:

-- No Settings --

Click to view an Example of a Sample Task which makes use of the Embedded YouTube Zone.