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 47 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 error message’ when previewing your task view 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 error message’ when previewing your task view the Media Error Message troubleshooting guide for further help.

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


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 Active Response Setting 'correct answer' is set, as static content, to 'Yes' (Setting 1). Sudden Death has also been turned on (Active Response Setting 2) which means once the participant has clicked on either button their answer is recorded and they will advance to the next screen. Neither of the zone specific settings (hide button and unlimited responses) have been used for either button.
Image of screen set up and configuration settings for two response Text buttons
Click Here To view the Metric Columns generated by a Response Button (Text) Zone
Each Response Button (Text) Zone, adds 1 row of new data to your metrics spreadsheet, when the button is pressed by the participant:
Column Name Row Response Description
Zone Type response_button_text This is the Zone Type name used to identify a Response Button (Text) Zone press within your metrics.
Reaction Time Reaction time as a number of milliseconds (ms) This is the reaction time (in ms), as measured from the start of the screen, at which the participant pressed the Response (Text) Button .
Response Text presented on the selected Response Button (Text) Zone This is the text that was contained in the Response Button (Text) Zone. For example, if you labelled your button 'yes', then the text in this response column will also read 'yes'.
Attempt Interger number representing the attempt number. This interger represents the attempt number for this response. The attempt number is shared across all Response Zones on a given screen. This metric is most relevant when using multiple response zones on a screen with Active Response setting 'sudden death' turned off, (or unlimited response setting turned on).

Example: If, on a given screen, the participant has 4 button options and selects button 'A' second, the attempt number next to response 'A' for this button will be '2'.
Correct Interger number, either 1 (correct) or 0 (incorrect) If a correct answer has been set using the Active Response Settings. And the response selected represents the correct answer this column will contain the value 1. If an incorrect answer is selected this column will contain a '0'.

Note: If a correct answer has not been set then this column will always contain '0's'.
Incorrect Interger number, either 1 (incorrect) or 0 (correct) If a correct answer has been set using the Active Response Settings. And the response selected represents the correct answer this 'Incorrect' column will contain the value 1. If an incorrect answer is selected this column will contain a '1'.

Note 1: If a correct answer has not been set then this column will always contain '1's'.
Note 2: Continue buttons and other advancement zones are automatically marked as incorrect.

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.

1) If (1 or 0) , do not hide the button after press

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

Default = 0 (Hide button on press); When the button is pressed, the button will be hidden and the participant will no longer be able to select this button as a response.

If set to 1 (Do not hide button on press); When the button is pressed, the button will not be hidden. Instead the button will remain on the screen and can be selected again by the participant.

Note: When set to 1, all the normal rules regarding Active Response Zones will still apply to this button. For example, if Active Response Setting(2) 'Sudden death' is set, the participant will still advance to the next screen after one response.


2) 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 (off); Participant will advance to the next screen as you have specified in the Active Response Settings.

If set to 1 (on); 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 (without unlimited responses) to advance the participant to the next screen.

Note: If this setting is turned on (set to 1) you must also turn setting-1 (do not hide button) on as well. If you do not also turn on setting-1 then the buttons will hide on first press and the participant will not be able to make unlimited responses.

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

Response Text Paragraph Zone


The Response Text Paragraph Zone (previously called Response Button Paragraph (Text) Zone), adds a simple clickable button containing a unformatted 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.

Note: If you wish to add styling to your paragraph use the Response Rich Text Paragraph Zone instead.

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 Text Paragraph 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 Text Paragraph Zone is typically used to ask participants to 'select' a response, or 'correct answer', from a set of other similar button options.

Response Text Paragraph Zone Icon:

Click Here To View An Image Example Of The Response Text Paragraph Zone & Configuration Settings
In the example below, the Response Text Paragraph Zone, 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 Text Paragraph 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 Text Paragraph Zone.

Response Rich Text Paragraph Zone


The Response Rich Text Paragraph Zone, (previously called 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 Text Paragraph 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 Rich Text Paragraph 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 Rich Text Paragraph 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 Rich Text Paragraph Zone Zone is typically used to ask participants to 'select' a response, or 'correct answer', from a set of other similar button options.

Response Rich Text Paragraph Zone Icon:

Click Here To View An Image Example Of The Response Rich Text Paragraph Zone & Configuration Settings
In the example below, the Response Rich Text Paragraph Zone, 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 Rich Text Paragraph 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 Rich Text Paragraph 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).
Image showing screen and configuration set up for two image response buttons
Click Here To view the Metric Columns generated by a Response Button (Image) Zone
Each Response Button (Image) Zone, adds 1 row of new data to your metrics spreadsheet, when the button is pressed by the participant:
Column Name Row Response Description
Zone Type response_button_image This is the Zone Type name used to identify a Response Button (Image) Zone press within your metrics.
Reaction Time Reaction time as a number of milliseconds (ms) This is the reaction time (in ms), as measured from the start of the screen, at which the participant pressed the Response (Image) Button.
Response Text presented on the selected Response Button (Image) Zone This is the text that was contained in the Response Button (Image) Zone. For example, if your image button used the image named 'Orange.PNG', then the text in this response column will also read 'Orange.PNG'.
Attempt Interger number representing the attempt number. This interger represents the attempt number for this response. The attempt number is shared across all Response Zones on a given screen. This metric is most relevant when using multiple response zones on a screen with Active Response setting 'sudden death' turned off, (or unlimited response setting turned on).

Example: If, on a given screen, the participant has 4 button options and selects button 'Orange.PNG' second, the attempt number next to response 'Orange.PNG' for this button will be '2'.
Correct Interger number, either 1 (correct) or 0 (incorrect) If a correct answer has been set using the Active Response Settings. And the response selected represents the correct answer this column will contain the value 1. If an incorrect answer is selected this column will contain a '0'.

Note: If a correct answer has not been set then this column will always contain '0's'.
Incorrect Interger number, either 1 (incorrect) or 0 (correct) If a correct answer has been set using the Active Response Settings. And the response selected represents the correct answer this 'Incorrect' column will contain the value 1. If an incorrect answer is selected this column will contain a '1'.

Note 1: If a correct answer has not been set then this column will always contain '1's'.
Note 2: Continue buttons and other advancement zones are automatically marked as incorrect.

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.


3) If (1 or 0) , do not hide the button after press

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

Default = 0 (Hide button on press); When the button is pressed, the button will be hidden and the participant will no longer be able to select this button as a response.

If set to 1 (Do not hide button on press); When the button is pressed, the button will not be hidden. Instead the button will remain on the screen and can be selected again by the participant.

Note: When set to 1, all the normal rules regarding Active Response Zones will still apply to this button. For example, if Active Response Setting(2) 'Sudden death' is set, the participant will still advance to the next screen after one response.


4) 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 (off); Participant will advance to the next screen as you have specified in the Active Response Settings.

If set to 1 (on); 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 (without unlimited responses) to advance the participant to the next screen.

Note: If this setting is turned on (set to 1) you must also turn setting-1 (do not hide button) on as well. If you do not also turn on setting-1 then the buttons will hide on first press and the participant will not be able to make unlimited responses.

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).


9) Collect slider value every (number) ms

Setting (number): Type a number to collect 

Default = No Default, when no number is set, the value of the slider is collected when the screen advances.

If set to a number, the slider value will be collected every x number of miliseconds, unless the value of the slider has not changed.

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 (Multi) Zone


The Keyboard Response (Multi) 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 (Multi) Zone will be unformatted and centred within the Zone area.

The Keyboard Response (Multi) 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 (Multi) Zones on the same screen. For example, if you need 4 keyboard options, use 2 Keyboard Response (Multi) Zones on a Screen.

Keyboard Response (Multi) Zone Icon:

Click Here To View An Image Example Of The Keyboard Response (Multi) Zone & Configuration Settings
In the example below, the Keyboard Response (Multi) 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 (Multi) 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.

Keyboard Space to Continue Zone


The Keyboard 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 Keyboard Space to Continue Zone to allow particpants to manually advance to the next screen using their keyboard. The Keyboard 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.

Keyboard Space to Continue Zone Icon:

Configuration Settings:

The Keyboard 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 Keyboard Space to Continue Zone.

Response Text Entry Zone


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

  • Edit the 'Active Response' Configuration Settings to set how the Response Text Entry Zone will function when a participant submits a text entry.
  • Edit the Zone specific configuration settings to adjust how the Response Text Entry Zone functions.

By default the participant must press the Enter key to submit their response unless this has been turned off using configuration setting-1. In which case another zone (either response or advancement zone) must be used to submit the participants response and allow the participants to advance to the next screen in your task.

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 Entry Zone when you want participants to enter a single word or sentence as a response to your question using a keyboard.

Response Text Entry Zone Icon:

Click Here To View An Image Example Of The Response Text Entry Zone & Configuration Settings
In the example below, the Response Text Entry 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 Entry Zone configuration settings

Configuration Settings:

The Response Text Entry 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 Entry 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 Entry Zone.

Response Text Entry (Multi) Zone


The Response Text Entry (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 Entry (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 Entry (Multi) Zone Icon:

Configuration Settings:

The Response Text Entry (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 Entry (Multi) Zone.

Response Text Entry Area Zone


The Response Text Entry 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 Entry 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 Entry Area Zone Icon:

Click Here To View An Image Example Of The Response Text Entry Area Zone & Configuration Settings
In the example below, the Response Text Entry 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 Entry 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 Entry 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.

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.

Note: coordinates are measured from top-left corner being (0,0)

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.

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.

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 differs 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 a Demo of the Keyboard Hold/Release Zone.

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.

Audio Recording Zone


The Audio Recording Zone allows you to record audio from your participants by utilising the participant’s microphone.

Note: The participant must accept the microphone permission notification that appears in their browser for this zone to function correctly.

How it works:
The Audio Recording Zone is a unique zone which differs from standard zones in 4 ways:

  1. How the Zone functions changes depending upon which operation mode (test or record) is chosen.
  2. The Zone will need to be set up on multiple screens. Every screen on which you wish to record a participant's voice needs to include an Audio Recording Zone.
  3. You can only use 1 Audio Recording Zone on a screen.
  4. Each audio recording is saved as a separate '.mp3' file which is stored and accessed separately. Expand and view the metrics panel below for more information.

Audio Recording Zone Set up:
The Audio Recording Zone has two modes of operation:

  1. Test Mode
  2. Record Mode

Edit Configuration Setting-1 to set the mode for the Audio Recording Zone. Both modes should be used at least once within your task.

Setting up 'test' Mode:
To set up the Audio Recording Zone in test mode:

Note that 'test' mode records no metrics, embedded data nor saves the audio recording as an '.mp3' file. Instead this mode allows the participant to instantly play back their recorded audio in order to make sure their voice can be heard and their microphone is working.

  1. Place the Audio Recording Zone on its own Separate Screen.
  2. Set the Audio Recording Zone Configuration Setting-1 to 'test'
  3. (Optional) We recommend limiting the maximum recording time (Configuration Setting-5) for the test mode to 3 seconds (3000ms).
  4. No other configuration settings are required or applicable to the Audio Recording Zone set to 'test' mode.
  5. Include a manual advancement zone (e.g. Continue buttons or Response Zones) on the same screen, so the participant can advance once they have finished testing their mircophone set up.

We recommend using 'test' mode at least once in your task to allow your participants to check the audio recording is working correctly with their microphone before advancing with your task.

Setting up 'record' Mode:
To set up the Audio Recording Zone in record mode:

  1. Place the Audio Recording Zone on each of your Task Screens where you wish to record your participants voice.
  2. Set the Audio Recording Zone Configuration Setting-1 to 'record'
  3. Edit the Configuration Setting 2-6 to configure exactly how you wish your audio recording zone to function. View the image example and configuration setting sections below for more details on each setting.

Use case:
Use the Audio Recording Zone when you need to record a participant's voice as part of a Task. This can be particularly useful for language and linguistic studies.

Audio Recording Zone Icon:

Click Here To View An Image Of How The Audio Recording Zone Appears To A Participant
The Audio Recording Zone with configuration setting-2 set to 0.
Image of the Audio Recording Zone as a participant sees it
Click Here To View An Configuration Set up Image Example for the Audio Recording Zone set to test mode.
Audio Recording 'test' mode Screen Set Up:

This image below shows the Audio Recording Zone set to test Mode - Configuration Setting-1 is set to 'test'.

Configuration Setting-5 has been set to 3000ms meaning the participant test recordings will be limited to 3s. Once the participant has recorded an initial microphone check the audio will be played back to the participant. They will then be given the option to replay back the audio again or re-record the audio.

Notice that in test mode we need to provide a way for participants to manually advance the screen. We have therefore included a continue button (manual advancement zone) on this screen to allow participants to advance the screen once they have finished testing their microphone recording set up.

We recommend including instructions on the test screen, like in our example below, to explain to your participants the behaviour they should expect from the audio recording test zone.

Configuration setting's 2,3,4 and 6 are not used in test Mode, these setting are left empty and unset.

Click Here To view the Task Metrics generated by the Audio Recording Zone
Audio Recording Zone Task Data

The Audio Recording Zone is unique in that the audio files generated by the Audio Recording Zone are stored in separate audio files, rather than being included within the Task metrics itself.

Instead whenever the Audio Recording Zone has been instructed to store Audio Recording metrics data, this will be recorded in your Task Metrics, where you will be provided with a URL link and data filename for the corresponding Audio Recording file.

Below you find an image example of the Task metrics produced by the Audio Recording Zone.

In the Image examples above. Blue, Green and Yellow represent three separate task trials. The section in grey has been truncated for the purpose of demonstration.


The Audio Recording Zone generates two rows in the Task metrics.

Column Name Row Response Description
Zone Type audio_recording This is the name that identifies the Audio Recording Zone in your metrics.
Response (Row 1) Data filename. Example: 000-0-task-NODEKEY-XXXXXX-audioFile-0-2.xlsx This is the unique name that will be given to your Audio file when you have downloaded your data from your Experiment's Data Page.

Note:
- NODEKEY will match your Task's Node Key found in your experiment tree.
- XXXXXX will be replaced by a unique session number.
- The data filename i.e. 'audioFile' will change if configuration setting 4 is set.
Response (Row 2) URL link to data file. Example: https://gorilla.sc/uploads/schedule/XXXXXX?filename=audioFile-0-2.xlsx This is the URL link which if pasted into a browser will allow you to download the corresponding Audio file.
When previewing your task this is how you can access your Audio file.

Note:
- XXXXXX will be replaced by a unique session number.
- The data filename i.e. 'audioFile' will change if configuration setting 4 is set.

Configuration Settings:</