Support Home Task Builder Zones

Task Builder Zones

  • Overview
  • Active Responses
  • Passive Responses
  • Content Zones:
  • Text
  • Rich Text
  • HTML
  • Image
  • Web Audio
  • Video
  • Embedded YouTube
  • Embedded Vimeo
  • Response Zones:
  • Continue Button
  • Response Button (Text)
  • Response Text Paragraph
  • Response Rich Text Paragraph
  • Response Button (Image)
  • Rating Scale/Likert (Passive)
  • Rating Scale/Likert (Active)
  • Response Slider
  • Effort Button
  • Dropdown
  • Keyboard Response (Single)
  • Keyboard Response (Multi)
  • Keyboard Space to Continue
  • Response Text Entry
  • Response Text Entry (Multi)
  • Response Text Entry Area
  • Feedback Zones:
  • Progress Bar
  • Feedback (Accuracy)
  • Feedback Audio (Accuracy)
  • Feedback (Speed)
  • Control Zones:
  • Fixation
  • Timelimit (Screen)
  • Timelimit (Section)
  • Go To
  • Jump to Row
  • Early Exit
  • Switch Button
  • Social Media Zones:
  • Share on Facebook
  • Share on Twitter
  • Advanced Zones
  • Change Blindness
  • Click Painting
  • Go/No Go
  • Go/No-Go (Audio)
  • Go/No-Go (Video)
  • Keyboard Hold/Release
  • Approach-Avoidance Task (Beta)
  • Audio Recording (Beta)
  • Mouse Tracking Zone (Beta)
  • Mouse Response Zone (Beta)
  • Reading (Beta)
  • Closed-Beta Feature Zones:
  • Canvas Painting
  • Eye Tracking
  • Gabor Patch
  • MouseView
  • Screen Calibration
  • Video Recording Zone
  • Video Feed Zone
  • Deprecated Zones:
  • Auto Advance (Deprecated)
  • Embedded YouTube (Deprecated)
  • Audio

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

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 Tutorial icon to view a Tutorial 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.

Click the Demo icon to view an Experiment 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


For a general guide to storing and using embedded data, see our walkthrough.


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) Text colour (setting)

Setting (colour): Type either a named colour (in lowercase) or a hexcode to change the text colour.

Default = black.


Advanced Settings


2) 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 allows you to format your text. Text can be formatted using both Markdown and HTML. However, if you want to include a significant amount of HTML formatting, you may prefer to use the dedicated HTML Zone.

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. You can also use it in conjunction with embedded data to show participants their responses or scores. Find out more about using embedded data here.

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

Advanced 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 Tutorial 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.


HTML Zone

The HTML Zone is a fully customisable zone which allows you to insert your own HTML content into a task. You can use it to add custom formatting to text or images, or to embed videos. The HTML Zone doesn't include any default formatting from Gorilla, so text will not be automatically centered as it is in the Text Zone and the Rich Text Zone.

Configuration Settings

-- No Settings --


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

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


2) If (setting) always show image at it's actual size.


If set, this will always display the image at its natural pixel size, rather than constraining it to the size of its containing zone. This ensures a consistent size, but may cause it to overlap other elements.


3) Set Image width to (setting) cm.


4) Set Image width to (setting) visual degrees.

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.

Web Audio Zone


The Web Audio Zone allows you to add a single uploaded audio (sound) file to your screen. It is very similar to the Audio Zone, but is designed to work well with autoplay. As long as the participant has interacted with the task in some way, such as by making a click, the Web Audio Zone will be able to autoplay.

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 Web 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 Web Audio Zone to contain the audio media you wish to present. The Web 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.

Note: the autoplay function may run into issues if a participant refreshes their browser page in the middle of a trial, but this should be a relatively rare occurrence.

Web Audio 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 audio will play automatically when the participant arrives at the screen of the Web Audio Zone.

If set to 1 (on) a play button will be shown allowing the participant to manually start the media playback.

While autoplay of audio in some browsers is no longer permitted, the Web Audio zone features improved capabilities for handling this. Provided you have at least one clickable button in a screen or display prior to your audio file being played, you participants are less likely to experience disruption from Autoplay restrictions.


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.


Advanced Settings


4) If (setting), provide additional metrics on audio events

Choose 1 for on or 0/unset for off. Default: 0/unset.


5) Audio format: (setting)

When playing audio files specified by embedded data, manually specify the format (usually wav or mp3) here. Default: mp3


6) Show Stop Button: (setting)

When playing audio, show a stop button allowing the audio file to be stopped. Choose 1 for on (show stop button), or 0/unset for off. Default: 0/unset

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


This zone can be localised. For more information visit our Localisation guide.


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 a 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:

Column Name Row Entry Description
Zone Type content_video This is the Zone 'Type' identifier for the Audio 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.


Advanced Settings


5) If (setting) , do not show the play overlay

Only applicable when using the Manual play option. If 1, will attempt to show the first frame of the video, rather than the play overlay.


6) If (setting) , loop the video once it starts playing

Choose 1 (loop) or 0. Default: 0. If set, will loop to the end of the trial - it will not respect max number of plays


7) If (setting) , provide additional metrics on video events

Choose 1 for on or 0/unset for off. Default: 0/unset.


8) Set Video width to (setting) cm

Requires Screen Calibration zone


9) Set Video width to (setting) visual degrees

Requires Screen Calibration zone

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


This zone can be localised. For more information visit our Localisation guide.


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:

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.

Warning

This zone is 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? The autoplay safety feature is used 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.


This zone can be localised. For more information visit our Localisation guide.


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:

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


Continue Button Zone Icon:

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.

Try out the link below to see this Zone in action:


Learn Gorilla: Tutorial


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


-- No Settings --

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

Response Button (Text) Zone


Response Button (Text) Zone Icon:

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.

Try out the link below to see this Zone in action:


Try out an Example


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.

Click Here To View the Metric Columns & Rows generated by a Video 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 Entry 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 [Number] 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 [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.

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


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.


3) If (setting) , do not advance the screen

Choose 1 (disable advance) or 0 (do not disable advance). Default: 0

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

Response Text Paragraph Zone


Response Text Paragraph Zone Icon:

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.

Try out the link below to see this Zone in action:


Try out an Example

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


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.

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


Response Rich Text Paragraph Zone Icon:

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.

Try out the link below to see this Zone in action:


Try out an Example

Click Here To View An Image Example Of The 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.


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.


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.

Try out the links below to see this Zone in action:


Try out an Example


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

Click Here To View the Metric Columns & Rows 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 Entry 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 [Number] 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 [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.

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.

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.


5) If (setting) , do not advance the screen

Choose 1 (disable advance) or 0 (do not disable advance). Default: 0

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.

Try out the link below to see this Zone in action:


Try out an Example


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.


The Rating Scale/Likert (Passive) Zone is a 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 Example 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.

Try out the link below to see this Zone in action:


Try out an Example


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.


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.

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 Example of the Rating Scale/Likert (Active) Zone.


Response Slider Zone


Response Slider Zone Icon:

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.

Try out the links below to see this Zone in action:


Learn Gorilla: Tutorial

Try out an Example


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 1) and a maximum value of 10 (Setting 2). The slider will start at 5 (Setting 4) and the tooltip is turned on (Setting 6) meaning the slider value will be shown to the participant as they choose a response. Setting 8, '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.


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


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


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


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


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


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


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


Advanced Settings


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.


10) Set the slider step size to (number)

Setting (number): Type a number for the slider to be incremented in.

Default = 1

If set to a number, the slider value can be increased or decreased in minimum increments of that number.


Click to view a Tutorial of the Response Slider Zone.

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


Effort Button


The Effort Button zone adds a button that needs to be clicked by a participant a desired number of times before progressing.

Examplar use of this zone could be to:

  • Reward participant for their effort
  • 'Punish' participant e.g. for getting the answer wrong
  • Check whether participant is paying attention to the stimuli you present them
Click Here To View An Image Example Of The Effort Button Zone & Configuration Settings

Try out an Example


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


1) Require (setting) presses to fulfill the amount of effort.

Default: 1

Setting (any): specify the number of times you require the participant to click the Effort Button in order to continue.


Advanced Settings


2) If (setting) , hide button border.

Default: 0. Choose 1 (hide border) or 0 (do not hide border).

If set to 1, the border surrounding the response Effort Button will be hidden. If set to 0, the border surrounding the response Effort Button will remain (default setting).


3) If (setting) , hide the button once the effort is complete.

Default: 0. Choose 1 (hide) or 0 (do not hide).

If set to 1, the response Effort Button will be hidden after participants click it the required number of times (i.e. complete the effort). If set to 0, the response Effort Button will remain on the page after the effort is complete (default setting).


4) If (setting) , do not advance the screen.

Default: 0. Choose 1 (disable advance) or 0 (do not disable advance).

If set to 1, the response Effort Button screen will not advance the screen. If set to 0, the response Effort Button will advance the screen on completion (default setting).


Click to view an Example of the Effort Button Zone used in three different ways in a Task.


Keyboard Response (Single) Zone


Keyboard Response (Single) Zone Icon:

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.

Try out the link below to see this Zone in action:


Try out an Example


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


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.


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


Advanced 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


Keyboard Response (Multi) Zone Icon:

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.

Try out the link below to see this Zone in action:


Try out an Example


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.


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.


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


Advanced 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


Keyboard Space to Continue Zone Icon:

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.

Try out the links below to see this Zone in action:


Try out an Example


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

Try out the links below to see this Zone in action:


Try out an Example


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


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.


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 (setting) record separate metrics for first key stroke and final submission (only valid if using enter key)

Choose 1 (record separate metrics) or 0. Default: 0


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

Try out the link below to see this Zone in action:


Try out an Example


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:

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


Response Text Entry Area Zone Icon:

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.

Try out the link below to see this Zone in action:


Try out an Example


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.


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


Progress Bar Zone


The Progress Bar Zone allows you to add a progress bar to your screen, which can be used to show participants how far they are through a task. For each trial containing a progress bar that a participant finishes the progress bar will fill up, indicating to the participant how far through your trials they have progressed.

Try out the links below to see this Zone in action:


Learn Gorilla: Tutorial

Learn Gorilla: Tutorial


How it works: Every row, i.e. 'trial', in your spreadsheet which has a 1 within the 'ShowProgressBar' column counts towards the total 'length' of your Progress bar. On completing a row of your spreadsheet, i.e. a display, then the progress bar will visually incrementally increase. This means that the bar will progress between displays, or between repeated displays, but not within displays (i.e. not between screens of the same display).

Unlike other Zones, the Progress Bar Zone must be set up using a Spreadsheet source.

  1. By default the source for the Zone content is set to Spreadsheet; this source type should not be changed.
  2. The default name for the corresponding spreadsheet column to be used with the Progress Bar Zone is 'ShowProgressBar'

Note: If you wish you can change the default name of 'ShowProgressBar' by clicking on the Zone and editing the Zone content. If you choose to do this be sure to also update your corresponding column heading in your Task Spreadsheet.

For every display you wish the progress bar to be presented on:

  1. Add a 1 in the Zones corresponding column. i.e. under the 'ShowProgressBar' column add 1's to all displays you wish the progress bar to be present on.

The same progress bar can be used across multiple different displays, so long as all displays have the Progress Bar Zone on them and they are all set up to use the same spreadsheet column name. The displays need not be contiguous - they can be separated by break screens.

The Progress Bar Zone is typically used to give the participant a sense of how long a task will take them. If you have a particularly long task, or an experiment with many tasks then Progress bars can be a helpful way of letting participants know when a break period is going to occur. This could encourage a participant to complete their current section or task.

Progress Bar Zone Icon:

Click Here To View An Image Example Of The Progress Bar Zone & Configuration Settings

In the example below, the Progress Bar Zone has been set-up to correspond with the spreadsheet column named 'Progress' (Zone content). The Progress Bar colour (Setting-1) has also been set-up to correspond with a spreadsheet column named 'ProgressColour'. This means that the spreadsheet controls both when the progress bar is displayed on a screen and the colour it appears as on each screen.


1) Progress bar colour (blue, grey, green, red) (colour)

Setting (colour): Type one of the 4 colours (blue, grey, green, red) you wish for your progress bar to appear.

Default = blue; the progress bar colour will be blue.

If this setting is also set to be controlled by a spreadsheet, colour can be varied between displays.

Click to view a Tutorial of the Progress Bar Zone.

Click to view a Example of a Sample Project which makes use of the Progress Bar Zone.


Feedback (Accuracy) Zone


The Feedback (Accuracy) Zone allows you to provide the participant with visual feedback about their accuracy based on their response.

Try out the links below to see this Zone in action:


Try out an Example


The Feedback (Accuracy) Zone must be used in conjunction with an Active Response Zone. This means:

  1. The Feedback (Accuracy) Zone must be used on a screen which also has at least one Active Response Zone.
  2. You must have configured setting-1 of the 'Correct Answer' Active Response Configuration Settings.

By default the feedback is displayed as a green tick (on a correct answer) and a red cross (on an incorrect answer). You can change these default images by editing the Zone content for the two sections of the Feedback (Accuracy) Zone:

  • (Optional) Left Side: Edit the Zone Content to set an alternative image for positive (correct answer) feedback: Upload the image under the Stimuli page and then enter the full file name (e.g. image.png) as the zone content.
  • (Optional) Right Side: Edit the Zone Content to set an alternative image for negative (incorrect answer) feedback: Upload the image under the Stimuli page and then enter the full file name (e.g. image.png) as the zone content. Supported Image types: .png, .jpg, .jpeg, and .gif

To control which type of feedback is displayed, feedback duration, and to change feedback 'honesty':

  • Edit the Feedback (Accuracy) Zone configuration settings.

The Feedback (Accuracy) Zone is typically used when you wish to present your participants with instantaneous visual feedback about the accuracy of their answers or responses to your question.

Note: You do not need to use a feedback zone to provide participants with their score; to show participants their score based on multiple responses, instead use the 'Embedded data settings' of the Active Response Zone configuration settings. Read more about using embedded data here.

Feedback (Accuracy) Zone Icon:

Click Here To View An Image Example Of The Feedback (Accuracy) Zone & Configuration Settings

In the example below, the Feedback (Accuracy) Zone has been set-up to show feedback for 500ms (Setting 3) on both correct and incorrect responses (Setting 1 & 2). Feedback is 100% honest as Feedback honesty settings are turned off (Setting 4 & 5). In this example a text response button called 'A' is set up to be the correct answer (Active Response config setting 1). If the participant selects this as their response, then the default 'green tick' feedback will be displayed. Any other response selected by the participant will result in the default 'red cross' feedback being displayed.


1) If (1 or 0) show feedback when response is correct

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

Default = 'Off' (0); No feedback is displayed.

If set to 1, turns on feedback: displays feedback when a correct answer is selected by the participant.

Note: You must have set up a correct answer in the 'Active Response Correct Answer' configuration settings for this to work.


2) If 1 or 0 show feedback when response is incorrect

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

Default = 'Off' (0). No feedback is displayed.

If set to 1, turns on feedback: displays feedback when an incorrect answer is selected by the participant.

Note: You must have set up a correct answer in the 'Active Response Correct Answer' configuration settings for this to work.


3) Show feedback for (number) milliseconds (Mandatory)

Setting (number): Type a numerical value for the amount of time, in milliseconds (ms), you wish feedback to be shown for.

Default = 0; No feedback will be displayed.

When set, feedback will be displayed for the specified amount of time once a response is selected by the participant.

If the screen would normally advance once the response has been entered; there will be a delay of this amount of time for the feedback to be shown before the screen is advanced. **i.e. Active Response Setting 'Sudden death' is turned on (set to 1) If the response would not normally advance the screen: the feedback will be shown for this length of time and then hidden again.


Advanced Settings


4) Percentage honesty in feedback when a response is correct (number)%

Setting (number): Type a numerical value between 0 and 100 to set the percentage of honesty for 'correct' answer feedback.

Default = 100; feedback is always (100%) honest. If the participant gives a correct answer, then the correct answer feedback will be presented 100% of the time.

If set to any value between 0 and 100 then the percentage of 'correct answer' feedback presented, upon a correct answer being recorded, will be honest the specified % of time.


In the metrics: A correct response will always be recorded as correct. The column 'dishonest' will have a 1 if the participant received dishonest feedback - and a 0 if the participant received honest feedback.

Note 1: If you wish to use Feedback Honesty setting, you MUST turn on Sudden Death in your Active Response Settings. i.e. Active Response Setting-2 (sudden death) must be turned on (set to 1).

Note 2: Feedback Honest will not work correctly with unlimited responses - although feedback provided to participants will be dishonest (if sudden death is turned on) the dishonesty will not be recorded in the metrics.


5) Percentage honesty in feedback when response is incorrect (number)%

Setting (number): Type a numerical value between 0 and 100 to set the percentage of honesty for 'incorrect' answer feedback.

Default = 100; feedback is always (100%) honest. If the participant gives an incorrect answer, then the incorrect answer feedback will be presented 100% of the time.

If set to any value between 0 and 100 then the percentage of 'incorrect answer' feedback presented, upon a incorrect answer being recorded, will be honest the specified % of time.


In the metrics: A incorrect response will always be recorded as incorrect. The column 'dishonest' will have a 1 if the participant received dishonest feedback - and a 0 if the participant received honest feedback.

Note 1: If you wish to use Feedback Honesty setting, you MUST turn on Sudden Death in your Active Response Settings. i.e. Active Response Setting-2 (sudden death) must be turned on (set to 1).

Note 2: Feedback Honest will not work correctly with unlimited responses - although feedback provided to participants will be dishonest (if sudden death is turned on) the dishonesty will not be recorded in the metrics.

Click to view an Example of a Sample Task which makes use of the Feedback (Accuracy) Zone.


Feedback Audio (Accuracy) Zone


The Feedback Audio (Accuracy) Zone allows you to provide the participant with audio feedback about the accuracy of their response.

Try out the link below to see this Zone in action:


Try out an Example


The Feedback Audio (Accuracy) Zone must be used in conjunction with an Active Response Zone. This means:

  1. The Feedback Audio (Accuracy) Zone must be used on a screen which also has at least one Active Response Zone.
  2. You must have configured setting-1 of the 'Correct Answer' Active Response Configuration Settings.

Edit the Zone content for the two sections of the Feedback Audio (Accuracy) Zone to select the audio to be played as feedback:

Note: Unlike the 'Feedback (Accuracy) Zone' this zone has no default audio feedback stimuli instead you must upload your own audio sound files to use within this zone.

  • (Mandatory) Left Side: Edit the Zone Content to set an audio stimuli for positive (correct answer) feedback: Upload the audio file under the Stimuli page and then enter the full file name (e.g. audio1.mp3) as the zone content.
  • (Mandatory) Right Side: Edit the Zone Content to set an audio stimuli for negative (incorrect answer) feedback: Upload the audio under the Stimuli page and then enter the full file name (e.g. audio2.mp3) as the zone content.

To control which type of audio feedback is displayed and change feedback 'honesty':

  • Edit the Feedback Audio (Accuracy) Zone configuration settings.

The Feedback Audio (Accuracy) Zone is typically used when you wish to present your participants with instantaneous audio feedback about the accuracy of their answers or responses to your question.

Note: You do not need to use a feedback zone to provide participants with their score; to show participants their score based on multiple responses, instead use the 'Embedded data settings' of the Active Response Zone configuration settings. Read more about using embedded data here.

Feedback Audio (Accuracy) Zone Icon:

Click Here To View An Image Example Of The Feedback Audio (Accuracy) Zone & Configuration Settings

In the example below, the Feedback Audio (Accuracy) Zone has been set-up to give feedback on both correct and incorrect responses (Setting 1 & 2). Audio files have been uploaded to the Stimuli page and the full file path is written in the Feedback Audio (Accuracy) zone as content for both 'correct' and 'incorrect' feedback options. Feedback is 100% honest as Feedback honesty settings are turned off (Setting 4 & 5). In this example a text response button called 'A' is set up to be the correct answer (Active Response config setting 1). If the participant selects this as their response, then the audio sound file 'YES.mp3' will play. Any other response selected by the participant will result in the audio sound file 'NO.mp3' being played.


1) If (1 or 0) give feedback when response is correct

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

Default = 'Off' (0); No feedback is displayed.

If set to 1, turns on feedback: displays feedback when a correct answer is selected by the participant.

Note: You must have set up a correct answer in the 'Active Response Correct Answer' configuration settings for this to work.


2) If 1 or 0 give feedback when response is incorrect

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

Default = 'Off' (0). No feedback is displayed.

If set to 1, turns on feedback: displays feedback when an incorrect answer is selected by the participant.

Note: You must have set up a correct answer in the 'Active Response Correct Answer' configuration settings for this to work.


3) Delay of (number) ms after audio feedback ends

Setting (number): Type a numerical value for the amount of time, in milliseconds (ms), you wish to delay after the audio feedback has ended.

Default = 0; No delay after feedback has finished playing, if the screen would advance it does so immediately.

When set if the screen would normally advance once the response has been entered; there will be a delay of this amount of time, after the audio feedback has finished playing, before the screen is advanced. **i.e. Active Response Setting 'Sudden death' is turned on (set to 1)


Advanced Settings


4) Percentage honesty in feedback when a response is correct (number)%

Setting (number): Type a numerical value between 0 and 100 to set the percentage of honesty for 'correct' answer feedback.

Default = 100; feedback is always (100%) honest. If the participant gives a correct answer, then the correct answer feedback will be presented 100% of the time.

If set to any value between 0 and 100 then the percentage of 'correct answer' feedback presented, upon a correct answer being recorded, will be honest the specified % of time.


In the metrics: A correct response will always be recorded as correct. The column 'dishonest' will have a 1 if the participant received dishonest feedback - and a 0 if the participant received honest feedback.

Note 1: If you wish to use Feedback Honesty setting, you MUST turn on Sudden Death in your Active Response Settings. i.e. Active Response Setting-2 (sudden death) must be turned on (set to 1).

Note 2: Feedback Honest will not work correctly with unlimited responses - although feedback provided to participants will be dishonest (if sudden death is turned on) the dishonesty will not be recorded in the metrics.

5) Percentage honesty in feedback when response is incorrect (number)%

Setting (number): Type a numerical value between 0 and 100 to set the percentage of honesty for 'incorrect' answer feedback.

Default = 100; feedback is always (100%) honest. If the participant gives an incorrect answer, then the incorrect answer feedback will be presented 100% of the time.

If set to any value between 0 and 100 then the percentage of 'incorrect answer' feedback presented, upon a incorrect answer being recorded, will be honest the specified % of time.

In the metrics: A incorrect response will always be recorded as incorrect. The column 'dishonest' will have a 1 if the participant received dishonest feedback - and a 0 if the participant received honest feedback.

Note 1: If you wish to use Feedback Honesty setting, you MUST turn on Sudden Death in your Active Response Settings. i.e. Active Response Setting-2 (sudden death) must be turned on (set to 1).

Note 2: Feedback Honest will not work correctly with unlimited responses - although feedback provided to participants will be dishonest (if sudden death is turned on) the dishonesty will not be recorded in the metrics.

Click to view a Example of the Feedback Audio (Accuracy) Zone.


Feedback (Speed) Zone


The Feedback (Speed) Zone allows you to provide the participant with visual feedback at a set time, if they have not yet given a correct response.

Try out the link below to see this Zone in action:


Try out an Example


  • (Mandatory) Edit the Zone content to set the text of the feedback you wish to be displayed.
  • (Mandatory) Edit the Zone's Configuration settings to set how the Feedback Zone functions.

Although it is not mandatory, the Feedback (Speed) Zone is typically used in conjunction with an Active Response Zone. This means:

  • The Feedback (Speed) Zone must be used on a screen which also has at least one Active Response Zone.
  • You must have configured setting-1 of the 'Correct Answer' Active Response Configuration Settings.

The Feedback (Speed) Zone is typically used to present feedback to the participant about the speed of their response - often to encourage them to answer as quickly as possible.

Alternatively, multiple Feedback (Speed) zones can be used to display messages to the participant at set times. e.g. as distractors while studying a stimuli presentation (video/text/image) or else as hints to help the participant answer a question.

Lastly, the Feedback (Speed) Zone, can be used to automatically advance a participant to the next screen at a set time if no correct answer has been given. This will therefore replace the need for a Timelimit (Screen) Zone in this scenario.

Feedback (Speed) Zone Icon:

Click Here To View An Image Example Of The Feedback (Speed) Zone & Configuration Settings

In the example below, there are two Feedback (Speed) Zones.

The 1st Feedback (Speed) Zone [Dark-Green] is set up to display the message 'Hurry - only 1 second left' (Zone content) for 1s (1000ms) (Setting-2), if the participant has not responded before 2s (2000ms) (Setting-1).

The 2nd Feedback (Speed) Zone [Light-Green] is set up to display the message 'Too slow! Better luck next time.' for a duration of 1s (Setting-2) after 3s has passed (Setting-1). The 2nd Feedback (Speed) Zone has additionally been set up to auto-advance the participant to the next screen (Setting-3) if the participant has not given a correct response before this point.


1) If no response after (number) milliseconds, show feedback

Setting (number): Type a numerical value for the time (in miliseconds) at which feedback will be displayed if the participant has not given a correct response.

Default = 0; Feedback will not be displayed.

If set, this represents the amount of time to allow participant to respond before showing the feedback text.


2) Display feedback for (number) milliseconds (Mandatory)

Setting (number): Type a numerical value for the amount of time (in miliseconds) the feedback should be displayed for.

Default = 0; Feedback will not be displayed.

If set, this represents the duration for which a participant will be shown the feedback text.


3) If (1 or 0) end the current trial without a response

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

Default = 0 (off); Feedback (Speed) Zone will not auto-advance the participant to the next screen.

If set to 1, the screen will automatically advance once the feedback text has finished being displayed.

Click to view an Example of a Sample Task which makes use of the Feedback (Speed) Zone.


Fixation Zone


Fixation Zone Icon:

The Fixation Zone allows you to add a single fixation cross to your screen.

  • [Mandatory] Edit the configuration settings to set the length of time (in ms) that the fixation cross should be displayed.

The fixation cross will be centred in the Fixation Zone's area.

Use the Fixation Zone to present a fixation cross to your participant between trials. The Fixation Zone is typically used when you want your participant to focus during a brief pause between stimuli displays or questions.

Try out the link below to see this Zone in action:


Try out an Example


Click Here To View An Image Example Of The Fixation Zone & Configuration Settings

In the example below, the Fixation Zone is set up to display the fixation cross for a total of 300ms (Setting-1). A pause time of 100ms has been set (Setting-2). This will result in a total screen display time of 500ms; 100ms wait before cross, 300ms show cross, 100ms wait after cross. Setting-1 is mandatory but Setting-2 is optional.


1) Show fixation cross for (number) milliseconds [Mandatory]

Setting (number): Type a value for the number of milliseconds (ms).

Amount of time the fixation cross is displayed for


2) Before and after showing the fixation cross, pause for (number) milliseconds

Setting (number): Type a value for the number of milliseconds (ms).

Default = 0; The fixation cross is shown immediatley. There is no pause time before or after showing the fixation cross. Once the fixation time (setting-1) is reached the next screen appears immediately.

If set, a pause time in milliseconds will be applied to the fixation zone. The pause time will appear as a blank screen and will be displayed before and after the fixation cross.

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

Timelimit (Screen) Zone


Timelimit (Screen) Zone Icon:

The Timelimit (Screen) Zone allows you to add a timelimit to your screen which will autoadvance a participant to the next screen in your display after a set amount of time.

The Timelimit (Screen) Zone, by default, does not have any visible display on a screen. However, you can edit configuration setting-2 to if you wish to display a visual countdown to your participant.

The Timelimit (Screen) Zone is typically used to limit the amount of time a stimuli (e.g. text or image) is shown for. It can also be used instead of a fixation zone; when you wish to present a break between trials as a blank screen. Alternatively, it can be used alongside Response zones to limit the time a participant has to answer a question.

Try out the links below to see this Zone in action:


Try out an Example


Click Here To View An Image Example Of The Timelimit (Screen) Zone & Configuration Settings

In the example below, the Timelimit (Screen) Zone is set to last 15s (15000ms) (setting-1). The countdown clock is set to be displayed for the full length of the timelimit (setting-2). A participant will therefore see a countdown for the full 15s of the timelimit before being automatically advanced to the next screen.


1) Automatically advance to the next screen after (number) milliseconds [Mandatory]

Setting (number): Type a time, as a number of milliseconds (ms), for the total duration of the time-limit.

The participant will be automatically advanced to the next screen after the set amount of time has elapsed.


2) Display countdown for the last (number) milliseconds

Setting (number): Type a time, as a number of milliseconds (ms), for which a countdown clock is displayed.

Default = 0; no countdown clock is displayed.

If set to anything >0; Displays a clock and pulsing countdown for the specified amount of remaining time (to the nearest second).

Note: This time must be equal to, or less than, the overall screen timelimit set in setting-1.

Click to view an Example of a Sample Project which makes use of the Timelimit (Screen) Zone.


Timelimit (Section) Zone


The Timelimit (Section) Zone allows you to add an overall timelimit to a block of trials or a whole task.

Try out the links below to see this Zone in action:


Learn Gorilla: Tutorial

Try out an Example


How it works: Every row, i.e. 'trial', in your spreadsheet which has a 1 within the 'TimedSection' column will be included in your time-limited section. The timelimit begins when the participant reaches the screen containing the Timelimit Zone.

Once the duration of the timelimit has elapsed, and the current screen has been finished, the participant will progress to the next display in the spreadsheet outside the timelimited section. i.e. to the next row which does not have a '1' under the 'TimedSection' column.

The time limit is only checked each time the participant reaches a screen which contains the Timelimit (Section) Zone (such as the same screen in a run of multiple trials). If the time limit duration has elapsed then only when the participant reaches and completes a trial screen containing a Timelimit (Section) Zone will the participant be prevented from continuing with the Trials within the time-limited section.

Setting up the Timelimit (Section) Zone: Unlike most other Zones, the Timelimit (Section) Zone must be set up using a Spreadsheet source.

  1. [Mandatory] By default the source for the Zone content is set to Spreadsheet; this source type should not be changed.
  2. [Mandatory] The default name for the corresponding spreadsheet column to be used for the Timelimit (Section) Zone is 'TimedSection'.

Note: If you wish you can change the default name of 'TimedSection' by clicking on the Zone and editing the Zone content. If you choose to do this be sure to also update your corresponding column heading in your Task Spreadsheet.

For every display you wish to be included in the timelimited section:

  1. [Mandatory] In your task spreadsheet add a 1 in the corresponding zones's column for that Display.

i.e. under the 'TimedSection' column add 1's to all displays you wish to be included in the time-limited section.

The same Timelimit (section) Zone can be used across multiple different displays but these displays must be continuous and all have the Timelimit (Section) Zone on them set up identically; i.e. to use the same spreadsheet column. Thus, these displays can be separated by break screens only if the break screen is also included in the timelimit.

Note: Displays in the Timelimited Section can not also be part of a block-randomisation (randomise_blocks). However, you can still use trial-randomisation (randomise_trials).

  1. [Mandatory] Edit the Zones Settings to set the duration of the time limit in milliseconds

i.e. set the total amount of time you wish participants to be able to spend on the section. By default this is set to 30,000ms (30s).

Once the duration of the timelimit has elapsed, and the current screen has been finished, the participant will progress to the next display in the spreadsheet outside the timelimited section. i.e. to the next row which does not have a '1' under the 'TimedSection' column.

The Timelimit (Section) Zone is typically used to limit the maximum about of time a participant can spend on a task or set of trials. It is also useful in cases where you are testing to see how many trials a participant can perform in a given amount of time.

Timelimit (Section) Zone Icon:

Click Here To View An Image Example Of The Timelimit (Section) Zone & Configuration Settings

In the example below, the Timelimit (Section) Zone has been set-up to correspond with the spreadsheet column named 'TimedSection' (Zone content) with a total time limit of 20s (Setting-1). This means that the spreadsheet controls which trials are part of the timed section. When the time-limit (Setting-1) is reached the participant will be shown the first display which is not part of this timed section.


1) Automatically advance to the next section after (number) milliseconds [Mandatory]

Setting (number): Type a time, in milliseconds (ms), for the total duration of the time-limit.

Default = 30000; The maximum amount of time a participant can spend on the section is 30s (30,000 ms).

Set the maximum amount of time a participant can spend on the section. Once the duration of the timelimit has elapsed, and the current screen has been finished, the participant will progress to the next display in the spreadsheet outside the timelimited section.


2) Use strict timelimit mode: (setting)

Set to Yes for task to immediately advance when the timelimit expires. Default: No

Click to view a Tutorial of the Timelimit (section) Zone.

Click to view an Example of a Task which makes use of the Timelimit (Section) Zone.

Go To Zone


Normally, a task will always advance on to the next screen in a display. The Go To Zone allows you to define a specific screen (within the current display), to move a participant to, following the completion of the current screen.

Try out the link below to see this Zone in action:


Try out an Example


The Go To Zone works in the same way as the 'advance to screen' setting of the 'Correct Answer' Active Responses Settings and is usually used in conjunction with the other 'Advanced branching Settings'. Allowing you to add this same functionality to screens without an Active Response Zone.

The Go To Zone is typically used when you wish to implement within-task branching. This is often used to show different screens to participants depending upon how the participant responds to a question. e.g. to advance the participant to specific response feedback screens for correct or incorrect answers.

Go To Zone Icon:

Click Here To View An Image Example Of The Go To Zone & Configuration Settings

In the example below, the Go To Zone has been set-up to advance the participant to the screen named 'finish' once the time-limit on the Timelimit (Screen) Zone has elapsed.


You can watch this video from our Video Walkthrough library to learn how to direct participants to specific screen based on their responses using Go To zone.


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

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

Default = None; Screen will advance as normal to the next screen in the display.

Set a screen name (within the same display). When the current screen is finished, Gorilla will then advance to the named screen within your current display.

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


Jump to Row Zone


The Jump To Row Zone allows you to break the normal flow of the Task spreadsheet by defining a row from your spreadsheet you wish your participant to move on to. This can be a specific row number, or the number of rows to jump. It should be used in conjunction with in-task Branching.

Try out the links below to see this Zone in action:


Learn Gorilla: Tutorial

Try out an Example


How it works: Normally, a task will always advance on to the display in the next row of the spreadsheet. Going through each Row of the spreadsheet, one-by-one, in order from top to bottom.

The Jump To Row Zone overwrites the normal flow of your Task spreadsheet. When the participant reaches a screen containing a Jump To Row Zone, instead of progressing to the next screen in the current display - or continuing on to the next row in your spreadsheet - the participant will jump to the row number you specify, or the number of rows you specify, and be shown the display listed in this row.

The Jump To Row Zone will activate once the current screen (containing the Jump To Row Zone) has been completed.

Warning

The Jump To Row Zone overwrites the normal order that a participant will go through your spreadsheet. If the Jump To Row Zone is set up incorrectly, it is possible to create infinite loops in your task, which will mean participants will not be able to reach the end of your task.

This can be avoided by always using the Jump to Row Zone in conjunction with the Active Response: 'Advanced Branching Settings'. Ensure your task is working correctly and as expected by previewing your task and piloting before launch.

Use Case: The typical use case for a Jump to Row Zone is when you wish to grant participants the option to repeat a sub-section of trials within a task. Such as repeating the practice trials of a task.

Another use case for the Jump to Row Zone is to be able skip sections of your task spreadsheet dependant on participants answers. This allows you to skip sections of your task you don't wish participants to see if they have given a particular response.

If you are jumping to a randomised trial, use the relative jump settings (Configuration setting 2).

Jump To Row Zone Icon:

1) When this screen is complete, jump to spreadsheet row (number)

Setting (number): Type a number of a row in your task spreadsheet.

Default = none; The task will continue as normal and will not jump to any row in the spreadsheet.

If set to anything >0; On completion of the screen the task will immediately jump to this row number.

The participant will be presented with the display contained in this row and will continue through the task spreadsheet row by row from this point onward (unless a Jump to Row Zone is met).

Note: The row number must exist in your task spreadsheet for the Jump to Row Zone to be able to function. Check the Spreadsheet Tab of your Task to check the row number you wish to reference.

2) When this screen is complete, jump (number) rows. Use negative integer to jump 'back' to a previous spreadsheet row

Setting (number): Type a number of rows in your task spreadsheet.

Default = none; The task will continue as normal and will not jump any number of rows in the spreadsheet.

If set to anything other than 0; On completion of the screen the task will immediately jump this number of rows.

The participant will be presented with the display contained in the row jumped to and will continue through the task spreadsheet row by row from this point onward (unless a Jump to Row Zone is met).

Note: The row you intend the participant to jump to must exist in your task spreadsheet for the Jump to Row Zone to be able to function.

Check the Spreadsheet Tab of your Task to check the row number you wish to reference.

Note: If setting 1 is set, setting 2 will be ignored.

Click to view a Tutorial of the Jump To Row Zone.

Click to view an Example which makes use of the Jump To Row Zone to allow participants to repeat practice trials within a Task.


Early Exit Zone


The Early Exit Zone allows you to break the normal flow of the Task spreadsheet by adding a button to the screen which when pressed will immediately end the current Task.

Try out the links below to see this Zone in action:


Learn Gorilla: Tutorial

Try out an Example


How it works: Normally, a task will always advance on to the display in the next row of the spreadsheet. Going through each Row of the spreadsheet, one-by-one, in order from top to bottom, until the task is completed.

The Early Exit Zone overwrites the normal flow of your Task spreadsheet. When the participant presses the Early Exit button the Task ends immediately. The participant will not see any further part of this Task. Instead the participant will advance to the next Node in your Experiment Tree.

Further to this, when a participant clicks the Early Exit Zone a piece of embedded data with the default name earlyExit is generated. This embedded data can then be used in your experiment Tree Branch Nodes to branch participants who have chosen to exit your task early via the early exit button.

  • Edit the Zone configuration settings to customise the name of the embedded data.

Use Case: The typical use case for a Early Exit Zone is to offer participants an option to withdraw from your experiment at any time. Further to this, the embedded data can be used to easily branch participants who withdraw to a Reject Node.

Other common use cases for the Early Exit Zone are in thresholding tasks and grit/perserverence studies. By making use of the embedded data setting (with source set to Spreadsheet) participants can be branched to tasks of different difficulty.

Explore the linked examples at the bottom of this page for a demonstration of experimental designs which make use of the Early Exit Zone embedded data.

Early Exit Zone Icon:

1) Store an early exit as Embedded Data called (text)

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

Default = earlyExit; The key-name given to the embedded data will be earlyExit.

If the text is changed from the default then your new text will become the key-name of the embedded data.


Embedded data & the Branch Node: When using the embedded data from the Early Exit Zone within a Branch Node. Set the Property field to be the key-name (e.g. earlyExit) and the Value field to be True. This will allow you to branch any participant who has clicked the early exit button within your task.

Note: The early exit zone will only generate embedded data if a participant has clicked the early exit button during the task. If you also wish to branch participants who have not clicked an Early Exit button then simply create a branch with both branch node fields left empty and set this as your default branch. This will allow you to separate out participants who clicked the early exit button from those who completed the task.

See the linked examples below for a demonstration of experimental set ups using the Early Exit Zone embedded data.

Click to view a Tutorial of the Early Exit Zone.

Click to view an Example of using the Early Exit Zone in a Task to allow participants to withdraw at any time.

Click to view an Example of an Experiment where the Early Exit Zone embedded data is used to branch participants who withdraw during the task.

Click to view an Example of using the Early Exit Zone to determine performance outcomes in a Thresholding Task.

Click to view an Example of an Experiment where the Early Exit Zone embedded data is used to branch participants depending upon their performance in the Thresholding Task.


Switch Button Zone


Switch Button Zone Icon:

The Switch Button Zone adds a 'Switch' button to the task screen which allows the participant to switch to the corresponding Switch Node Task in your experiment.

Try out the link below to see this Zone in action:


View a Demo


Setting up the Switch Button Zone

  • Edit the Zone Content to edit the label of the button. By default this is 'Switch'.

Note: The Switch Button Zone is a special Zone which must be used in conjunction with a Switch Node within your Experiment Tree in order to make use of its functionality. You must include a Switch Button Zone in both of the Tasks tethered to your Switch Node if you wish your participants to be able to switch freely between the tasks.

You must include a Switch Button Zone on every Screen of your Tasks that you wish your participant to be able to switch from.

The Switch Button Zone is only used when using the Switch Node within your Experiment Tree. You can find out more about the Switch Node here.

Click Here To View An Image Example Of The Switch Button Zone & Configuration Settings

In the example below, you can see that there are no configuration settings for the Switch Button Zone. The Switch button label has been changed from the default of 'Switch' to 'Switch to Task 2!' by editing the Zone content.

This image example shows how the Switch button appears disabled when Previewing it as a Task. Notice that the switch button will only function when previewing from the experiment itself (i.e. when the task is tethered to another task via the Switch Node).

Click Here To View the Metric Columns generated by a Switch Button Zone & Switch Node
Column Name Description
switch-nodekey-time-primary This is the total time (in ms) the participant spends on the primary task.
switch-nodekey-percentage-primary This is the time the participant spent on the primary task displayed as a percentage.
switch-nodekey-time-secondary This is the total time (in ms) the participant spends on the secondary task.
switch-nodekey-percentage-secondary This is the time the participant spent on the secondary task displayed as a percentage
switch-nodekey-switches This is a count of the total number of switches a participant made between the primary and secondary tasks.
Column Name Row Response Description
Response SWITCH This is the reaction time (in ms) at which the participant pressed the Switch Button.
Response SWITCH ELAPSED This is the total time (in ms) that the participant has spent on the task before pressing the Switch button.

-- No Settings --

Click to view a Demo of the Switch Button Zone and Switch Node.

Share on Facebook Zone


The Share on Facebook Zone allows your participants to post a link on Facebook by pressing a ‘Facebook’ button. This creates a popup, which, when they log into Facebook, allows them to write a post containing a predetermined link.

No metrics are recorded when the participant presses the Facebook button, nor when they post to Facebook.

Note: Links to Gorilla Experiments should always be copied and pasted into the browser, rather than opened within the Facebook app, or they may not function correctly. If you are using this zone to share a link to a Gorilla Experiment, you need to ask participants to include this instruction in their Facebook Post.

Share On Facebook Zone Icon:

Click Here To View An Image Example Of The Share on Facebook Zone & Configuration Settings

In the example below, you can see that there are two configuration settings for the Share to Facebook Zone. The Share to Facebook URL has been set to an external page. The button label has been left to default 'Share on Facebook'.

This image example shows how the Share to Facebook Zone appears when Previewing it as a Task.


1) Share the following URL (mandatory)

Setting (text): Type the URL you wish to be entered into the Facebook post.

Default = no default; If this setting is not set, the Share to Facebook button will not appear to the participant.

When this is set, the URL you give will automatically appear in the Facebook popup post area.

2) Set button label to (text)

Setting (text): Type the name-label you wish the button to have.

Default = If this setting is not set, the button will read 'Share on Facebook'.

Share on Twitter Zone


The Share on Twitter Zone allows your participants to post a link on Twitter by pressing a ‘Twitter’ button. This creates a popup, which, when they log into Twitter, allows them to write a post containing a predetermined link.

No metrics are recorded when the participant presses the Twitter button, nor when they post to Twitter.

Note: Links to Gorilla Experiments should always be copied and pasted into the browser, rather than opened within the Twitter app, or they may not function correctly. If you are using this zone to share a link to a Gorilla Experiment, you need to ask participants to include this instruction in their Tweet.

Share On Twitter Zone Icon:

Click Here To View An Image Example Of The Share on Twiter Zone & Configuration Settings

In the example below, you can see that there are two configuration settings for the Share to Twitter Zone. The Share to Twitter URL has been set to an external page. The button label has been set to 'Check out this page!'.

This image example shows how the Share to Twitter Zone appears when Previewing it as a Task.


1) Share the following URL (url) [Mandatory]

Setting (text): Type the URL you wish to be entered into the tweet.

Default = no default; If this setting is not set, the Share to Twitter button will not appear to the participant.

When this is set, the URL you give will automatically appear in the Twitter popup post area.

2) Set default tweet message to (text)

Setting (text): Type the tweet text you’d like the participant to post (this is editable by the participant).

Default = Gorilla; The word ‘Gorilla’ will precede the URL.

Change Blindness Zone


Change Blindness Zone Icon:

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.

Try out the links below to see this Zone in action:


Learn Gorilla: Tutorial

Try out an Example


Setting Up a Change Blindness Zone:

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


Use case:

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.


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


Note the Change Blindness Zone does not produce any unique Metrics

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.


Advanced Settings


3) Set Image width to (setting) cm

Requires Screen Calibration zone


4) Set Image width to (setting) visual degrees

Requires Screen Calibration zone

Click Painting Zone


Click Painting Zone Icon:

The Click Painting Zone adds an interactive image zone to your screen which allows participants to click on the image, placing a coloured dot at the click location.

Try out the links below to see this Zone in action:


Learn Gorilla: Tutorial

Try out an Example


The Click Painting Zone provides a single input for the image the participant is to mark with dots.

When a participant clicks on the image in the click painting zone, the (x,y) coordinates of the click within the image are recorded in the metrics for the screen. A dot is visibly placed on the screen, centered where the participant clicked.

It is important to note that the (x,y) coordinates take into account the scaling of the image. The size of the dot, however, does not affect the coordinates. See set up section below for more information.

Note: While the Click Painting Zone records a response from the user, the response is not marked as correct or incorrect.


Setting up a Click Painting Zone:

  • Edit the Zone content to set the image you wish to be presented as the Click Painting.
  • Edit the Configuration Settings for the Click Painting Zone to set up the Zone functionality you can set:
    • The maximum number of clicks
    • The colour of the clicks
    • The size of the click dot

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.


Use Case: Use the Click Painting Zone when you want participants to locate or identify an object or feature within an image and need to obtain position metrics (x and y coordinates) for the click locations.

Note: If you do not wish to collect position data you may instead wish to use the Canvas Painting Zone as an alternative to the Click Painting Zone.

Click Here To View An Image Example Of The Click Painting Zone & Configuration Settings

In the example below, the Click Painting Zone, has been set up to show an image 'brain.jpg', which is set as the static content for this Click Painting Zone.

The number of clicks has been limited to 1 using Configuration Setting-1. This means the participant will only be allowed to click once on this image before being advanced, automatically, to the next screen

The dot colour and size has been configured using Configuration Setting-2 and 3 respectively. From these settings we can see that a 20px blue dot will be displayed at the point where the participant clicks.

Click Here To View the Metric Columns & Rows generated by a Click Painting Zone

The Click Painting Zone produces specific metrics in 4 columns within your Data-Spreadsheet.

The Click Painting Zone will produce one row in your metrics for each click on the click painting zone the participant makes. Up to the limit set in Configuration Setting-1

The zone will produce one additional row in your metrics to indicate if, and when, the click limit is reached.

You can view an example of the metrics produced by the Click Painting Zone in the image below:

Note the metric columns in grey have been hidden for presentation purposes.

Column Name Row Entry Description
Zone Type click_painting This is the Zone 'Type' identifier for the Click Painting Zone.
Reaction Time [Number] This is the reaction time in milliseconds (ms). The reaction time is recorded at the point the participant clicks on the image in the Click Painting Zone.
Response click This indicates that the participant clicked on the image in the Click Painting Zone.
Response click limit reached This indicates that the click limit set in Configuration Setting-1 has been reached. The Participant has performed the maxinum number available clicks on the Click Painting Zone image
Attempt [Number] e.g. 1, 2, etc This indicates the number of times the participant has clicked on the Click Painting Zone.
X Coordinate [Number] e.g. 53, etc This indicates the x-coordinate for the position of the participants click, on the Click Painting Zone.
Note that the coordinate system origin point (0,0) is the top-left corner of the image.
Y Coordinate [Number] e.g. 87 etc This indicates the y-coordinate for the position of the participants click, on the Click Painting Zone.
Note that the coordinate system origin point (0,0) is the top-left corner of the image.

1) Limit number of clicks to (number) [Mandatory]

Setting (number): Type a number to set the number of times a participant needs to click on the Image. Default = none.

Once the participant has clicked on the image the specified number of times, Gorilla will automatically advance the participant to the next screen.

After the last click a wait time of 250ms is implemented: This allows the participant to view the position of their last click before being moved on to the next screen.

Only clicks on the click painting zone will be recorded.

Note: If a number is not configured in this setting then the Zone will not function.

2) Click colour (red, yellow, blue or green) (string) [Mandatory]

Setting (string): Type the name, choosen from the available options (red, yellow, blue or green), for the colour you wish the dot to be. Default = none.

When the participant clicks on the image a dot will appear, centered at the position where the participant clicked.

The dot's will stay upon the image until the click limit is reached.

You must set a numerical value for the dot-size in configuration setting-3 for the dot to be visible.

Note: If a colour option is not configured in this setting then the Zone will not function.

3) Size of click (in pixels) (number)

Setting (number): Type a number to set the pixel size of the dot to be. Default = none: When the participant clicks on the image no dot will be shown. The coordinates of the click point will still be recorded in your metrics.

Set to a number, which represents the size, in pixels, of the dot which appear on the image at the location the participant clicks.

Note that the (x,y) coordinates, recorded in your metrics, will always represent the centre of the dot. As the centre of the dot is the co-ordinates used, the dot size will not affect your data.

Click to view a Tutorial of the Click Painting Zone.

Click to view a Example of the Click Painting Zone.


Go/No Go Zone


Go/No-Go Zone Icon:

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 simultaneously grants the additional functionality of recording a 'NoGo' response or an 'inhibited' response as a named response.

Try out the links below to see this Zone in action:


View a Demo

Try out an Example


How it works: 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.


Setting up a Gabor Patch Zone:

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, and .jpeg.

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.

Use Case: 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.

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.


Advanced Settings


6) Set Image width to (setting) cm

Requires Screen Calibration zone


7) Set Image width to (setting) visual degrees

Requires Screen Calibration zone

Click to view an Example of a Task which makes use of the Go/No-Go Zone.

Click to view a Classic Experiment about Inattention & Impulsivity in children during the Go/No-Go Task.

Go/No-Go (Audio) Zone


Go / No-Go Audio Zone Icon:

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.

Try out the link below to see this Zone in action:


Try out an Example


How it works:

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.


Setting up the Go/No-Go Zone: There are three main steps to setting up an Audio Go / No-Go Zone:

  1. Upload your Audio Stimuli in the stimuli tab of your task.

Supported audio file types: .mp3, .ogg.

  1. Edit the Zone Content to add your audio stimuli You should first upload your stimuli under the Stimuli Tab of your Task and use then full file name (including file type) when referencing your Audio file.

Note: If you wish to use Image Stimuli instead of Audio stimuli you will need to use the Go/No-Go Zone.

  1. Edit the Zone's Configuration Settings to set how the Go/No-Go (Audio) Zone should function.

Use Case:

The Go/No-Go (Audio) Zone is primarily used for implementing go/no-go experimental paradigms. However this Zone is also highly applicable to Audial search and Stimulus-Response compatibility tasks.

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.


Go/No-Go (Video) Zone


The Go/No-Go (Video) Zone is specialised for implementing video go/no-go style experimental paradigms. This specialised Zone allows you to present a video stimuli, while allowing the recording of a 'NoGo' response or an 'inhibited' response as a named response.

Try out the link below to see this Zone in action:


Try out an Example


How it works:

The Go/No-Go (Video) 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 (Video) 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.


Setting up the Go/No-Go Zone:

  1. Upload your Video Stimuli in the stimuli tab of your task.

Recommended video file type: .mp4

  1. Edit the Go No Go (video) Zone Content to add your video stimuli

You should first upload your stimuli under the Stimuli Tab of your Task and use then full file name (including file type) when referencing your Video file.

Note: If you wish to use Image Stimuli instead of Video stimuli you will need to use the Go/No-Go Zone.

  1. Add any Active Response Zone - e.g. response button or keyboard response - to detect the 'Go' response.

  2. Edit the Zone's Configuration Settings to set how the Go/No-Go (Video) Zone should function.


Use Case:

The Go/No-Go (Video) Zone is primarily used for implementing the go/no-go experimental paradigms with the video stimuli.


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. See the Active Response Zone settings for more information.


2) If (setting) continue to end of video stimuli after user response.

Set to Yes to continue. Default: No.

If setting is set to Yes, the video will play till the end even after participant has responded (Go).

If set to No, the video will cut off immediately upon participant's response and the task will move onto the next screen/display.


3) If (setting) mute audio track in video.

If set to 1, the video will be muted.

If 0 (default), the video will be displayed with the sound.


Advanced Settings


1) If (setting) , provide additional metrics on video events

Choose 1 for on or 0/unset for off. Default: 0/unset.

If set to 1, you will find additional information on video events in your downloaded data. These will include:

VIDEO STARTED,

VIDEO PLAYING EVENT FIRED,

VIDEO TIMEUPDATE EVENT FIRED,

ADJUSTED START TIME based on TIMEUPDATE EVENT

You might find these useful for your analysis or might want to skip them if you only need information on participant's response (Go or No Go).

If set to 0, you will not receive these additional information regarding video events.


2) Set Video width to (setting) cm

If you wish to use this setting, you will need to include a Screen Calibration zone.


3) Set Video width to (setting) visual degrees

If you wish to use this setting, you will need to include a Screen Calibration zone.


Click to view an Example of a Sample Task which makes use of the Go/No-Go (Video) Zone.


Keyboard Hold/Release Zone


Keyboard Hold/Release Zone Icon

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

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.

1) Use (Hold or Release) mode (either 'Hold' or 'Release') [Mandatory]

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

Click to view an Example of the Keyboard Hold/Release Zone in a Task.

Click to view a Demo of an Experiment which contains the Keyboard Hold/Release Zone Task game.


This zone can be localised. For more information visit our Localisation guide.


Approach Avoidance Task (AAT) Zone


This zone is in BETA. Use at your own risk and please report any issues promptly.


The AAT Zone allows participants to move an image on the screen using their arrow keys. It is designed for use in Approach Avoidance Tasks.

The illusion of an increase or decrease in distance towards the object is supported by a zooming effect, which occurs when participants move the image using the up and down arrow keys. Alternatively, the AAT Zone can be configured so that participants move the image sideways using their left and right arrow keys.


Try out an Example


How it works:

Add an AAT Zone to your task and then set its value to be an image you have uploaded in your stimuli. You can either set the image as static content, so that the same image is always presented, or set the image to change using your task spreadsheet or a manipulation.

When you download your data, you will recieve information on all the arrow key responses participants have made, with the reaction time for each.

AAT Configuration Settings

1) Run as neutral trials (yes, no)

Default = no; image can be moved up and down with zooming effect.

If set to yes, images can be moved left and right (with no zooming effect) rather than up and down.

2) Run as practice trials (yes, no)

Default = no; feedback will not be displayed

If set to yes, feedback will be displayed during the trial.

3) Feedback text (yes, no)

Default = incorrect; the text displayed on an incorrect answer will be 'incorrect'.

If set to any other value, that text will be displayed instead.

4) Feedback text size ()px

Default = 14; text will be displayed at a size of 14px

If set to any other number, text will be displayed at that pixel size instead.

Audio Recording Zone


This zone is in BETA. Use at your own risk and please report any issues promptly.

Warning

KNOWN ISSUES

June 2020 (ISSUE): There is a lag time between Gorilla requesting the microphone to start recording and the microphone beginning data collection. This can cause the beginning of a participants audio response to be cut off. In the short term, if your task requires participants to respond to a visual stimuli presented on the screen, you should delay the onset of that stimuli by 500-1000ms. This can usually only be achieved using script (which, at the moment, is available via the support desk on request). If participants respond to an audio stimuli, we recommend adding some empty space at the beginning of the audio track.

June 2020 (ISSUE): If an Audio Recording screen is ended by another zone (Timelimit(Screen), Response Button Text etc.) rather than the Audio Recording zone itself, this can cause the end of the Audio stream to be lost. In the short term, if your task requires that another zone end the screen, you should delay the effect of that zone by 500-1000ms, to allow time for the Audio Stream to clear. This can usually only be achieved using script. You can find two examples of this here and here

(DEV UPDATE): Actions are being taken during the course of the next few months to reduce the impact of these two issues, hopefully to the point that additional scripts will no longer be necessary.


Audio Recording Zone Icon:

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.

Try out the links below to see this Zone in action:


View a Demo

Learn Gorilla: Tutorial

Try out an Example


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 '.weba' file which is stored and accessed separately. If you would prefer to create an mp3 file, you can change the default in the zone configuration settings. Expand and view the metrics panel below for more information.

Note: When previewing a task, your additional files can be accessed via a URL placed in the metrics. When running a full experiment, all of the additional files can be accessed from the 'Manage Experiment Data' button on your Experiments Data page. The zip folder with all your metrics data will include an 'Uploads' folder, containing all of your additional files.


Setting up the Audio Recording Zone: 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.


1) Use the (test or record) mode (choose 'test' or 'record')

Setting (test or record): Type either 'test' or 'record' to choose the operation mode for the Zone. Default = test; If no mode is set the Audio Recording Zone will default to the 'test' mode.

Test: In test mode the Audio Recording Zone will record audio, and allow the participant to replay the audio to check that their microphone is functioning correctly. Test mode records no metrics.

Record: In record mode the Audio Recording Zone will record participant audio and return the recorded audio to the Audio Recording Zone Metrics.


2) If (1 or 0) automatically begin recording on screen start. [record mode ONLY]

Setting (1 or 0): Type either 1 to turn the setting on, or 0 to turn the setting off. Default = 0; By default, the Audio Recording Zone will begin recording when the 'Start Recording' is pressed.

If set to 1; The Audio Recording Zone will begin recording when the screen starts.

If set to 0; The Audio Recording Zone will only begin recording when the 'Start Recording' is pressed, and stop recording when a 'Stop recording' button is pressed.

Note: If this setting is set to 1, and there is no continue button or active response zone on screen, configuration setting-5 must also be set, or else the screen will not progress.


3) If (1 or 0) automatically advance to the next screen when recording is complete. [record mode ONLY]

Setting (1 or 0): Type either 1 to turn the setting on, or 0 to turn the setting off. Default = 1; By default, the Audio Recording Zone will automatically advance to the next screen when either the recording is complete or the maximum recording time is reached (Configuration Setting-5).

Note: When set to 1, you do not need to include any other Advancement Zones such as Timelimit (Screen) Zones. Instead you can use the configuration setting-5 to set a maximum record length. If either the participant finishes talking or the maximum record length is reached the Audio Recording Zone will stop recording and the screen will advance automatically.

If set to 0; The screen will not advance when the participants has finished recording nor when the maximum recording time has been reached. Instead you must also include an advancement zone (e.g. Continue Button or Timelimit (screen) Zone) or response zone on the same screen so that participants can advance the screen manually.

4) Prefix filename with (text) for captured audio [record mode ONLY]

Setting (text): Type a name to identify the recorded audio file. Default = audioFile; By default, the Audio Recording Zone will produce an audio file with the filename audioFile-1-3, or similar.

If set to any text string; this changes the filename of the recorded audio file e.g. if set to TaskAudio, the file will be named TaskAudio-1-3.

Note: only use alpha-numeric characters in your file names. Do not use special characters as this could prevent you from retrieving data files.

You will likely wish to use this setting with spreadsheet 'source' if you wish to uniquely identify your recorded audio files on a 'per-trial' basis.

Review the metrics section above for details on the default file name structure.


5) Set max recording time to (number) ms (Maximum: 120000 ms, i.e. 2min)

Setting (number): Type a duration in milliseconds (ms) to set the maximum recording time. Default = 120000; By default, the maximum recording time equals the allowed maximum of 120000 milliseconds (2 minutes).

When set, this restricts the length of an audio recording to the number of milliseconds you enter. Once the maximum recording time has been reached the Audio Recording Zone will stop recording. Maximum possible recording length is 120000 ms (2 minutes).

This setting is particularly useful when you have set the screen to auto-record and auto-advance, as it stops the recording at the duration set allowing the screen to progress at a set time.


6) Store URL as embedded data called (text) [record mode ONLY]

Setting (text): Type a key-name for the embedded data. Default = none; No key is created, no embedded data is stored.

If set to any text-string, this will store the recorded audio as embedded data under the given key name.

You can then retrieve this audio file later using this key name. Enter your key name as embedded data - e.g. $${myEmbeddedDataKeyName} - into an Audio Zone to replay the recorded audio back to the participant.

Note: Audio embedded data cannot be retrieved on a screen directly after it is recorded. There must be an intermediary screen of at least 550ms.

Click to view a Tutorial of the Audio Recording Zone.

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

You can try out the Audio Recording Zone as a participant by taking our Demo here: Try out Audio Recording Now!



This zone can be localised. For more information visit our Localisation guide.


Mouse Tracking Zone

This zone is in BETA. Use at your own risk and please report any issues promptly.


The Mouse Tracking Zone allows you to record a participant’s mouse movements during a screen or continuously over multiple screens. The (x,y) coordinates of the cursor are pulled several times a second, and then recorded in a unique Mouse Tracking metrics file.

Try out the links below to see this Zone in action:


View a Demo

Learn Gorilla: Tutorial

Try out an Example


Setting up the Mouse Tracking Zone:

  1. Place the Mouse Tracking Zone on each of your Task Screens where you wish to use mouse tracking.

  2. Edit Configuration Setting-1 of the Mouse Tracking Zone to determine how the Mouse Tracking Zone should record and store metric data. More information is available in the configuration setting section below.

Use Case: Use the Mouse Tracking Zone when you wish to detect and record approximately where a participant's mouse is focused when participating in your task, for example when choosing between responses, or in anticipation of stimuli presentation.

1) If (1 or 0) continue recording after the end of this screen. Only set this if you are recording data across multiple screens, and ensure that the last screen does not have this set. Use 1 to continue recording and 0 to stop recording.

Setting (1 or 0): Type either 1 or 0 to select if the Mouse Tracking Zone should continue recording.

Default = 0; By default, the Mouse Tracking Zone will stop collecting data when the screen is advanced, producing a unique Mouse Tracking data file for this screen.

If set to 1; The Mouse Tracking Zone will continue to record the mouse movements of the participant between screens containing an Mouse Tracking Zone.

If set to 0; The Mouse Tracking Zone will stop recording once the screen has been advanced and a unique metrics file containing the Mouse Tracking data will be created.


2) Prefix filename with(text) for captured data.

Setting (text): Type a name to identify the mouse tracking data file.

Default = mousetracking; By default, the Mouse Tracking Zone will produce data with the filename mousetracking-1-3, or similar.

When set to any text, this changes the filename of the Mousetracking data i.e. if set to 'MouseTask', the file might be named 'MouseTask-1-3'.

Note: Only use alpha-numeric characters in your file names. Do not use special characters as this could prevent you from retrieving data files.

Click to view a Tutorial of the Mouse Tracking Zone. Choose 1 (allow unlimited) or 0. Default: 0

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

You can try out the Mouse Tracking Zone as a participant by taking our Demo here: Try out Mouse Tracking Now!


Mouse Response Zone


This zone is in BETA. Use at your own risk and please report any issues promptly.


The Mouse Response Zone allows participants to respond using their mouse's left and right clicks.


Try out a Mouse Response Zone Example


Setting up the Mouse Response Zone:

  1. Place the Mouse Response Zone on each of your Task Screens where you wish to use mouse response.

  2. Edit Configuration settings of the Mouse Response Zone to determine what the Mouse Response Zone should record left and right mouse clicks as.

1) Record left/right mouse click as (setting).

To use the left/right mouse click as a response option, this value MUST be set. Default: none.

You will notice when you add the zone that left click will automatically be assigned to the LEFT static value and right click to the RIGHT static value. These can be changed by clicking on the values, selecting the source and typing the name of the value you wish to use for each click.


2) If (setting) allow unlimited responses (disables advance on correct response).

Choose 1 (allow unlimited) or 0. Default: 0

When set to 1, participants will be able to give unlimited responses and their response will not progress the screen onto the next one. If using this, you should add a zone that will allow for the screen to progress e.g. a Timelimit (Screen) zone or a Continue Button - otherwise participants will not be able to advance.

Click to view an Example of a simple Task which makes use of the Mouse Response Zone.


Reading Zone

This zone is in BETA. Use at your own risk and please report any issues promptly.


Reading Zone Icon:

The Reading Zone is an advanced content zone specifically designed for building paced and self-paced reading tasks.

The Reading Zone provides multiple configuration options which enable the creation of a wide variety of reading task paradigms. In addition to the choice of mode (Paced or Selfpaced), the Reading Zone includes options for timing and trigger method. It also provides options for where and how reading content is presented via the location, presentation style and masking configuration settings.

Try out the links below to see this Zone in action:


View a Demo

Learn Gorilla: Tutorial

Try out an Example


How it works:

The Reading Zone is a unique zone which differs from standard zones in 6 ways:

  1. How the Zone functions, changes depending upon which operation mode (Paced or Selfpaced) is chosen.
  2. Presentation of text content entered into a Reading Zone is separated using the pipe symbol (|) as the delimiter.
  3. You should only use 1 Reading Zone on a screen.
  4. How the Zone records and stores Reaction Time metrics depends upon which recording configuration setting is chosen.
  5. The Reading Zone automatically advances participants to the next screen in your Task on completion of the presentation of Reading Zone content. Avoid including any advancement zones (e.g. Continue buttons, Time-limits or Response Zones) on the same screen.
  6. Only HTML may be used to add styling to text content, markdown will not work.

Under the bonnet Gorilla takes the full text content entered into the Reading Zone and splits it up into separate presentation segments whenever it finds a pipe symbol (|). Pipe symbols act as the delimiter which allows you to control what text content is shown in each segment. The configuration settings of the Reading Zone then determine how each segment of the content is displayed to the participant. View the examples and configuration settings sections below for more details on how this works.


Setting up the Reading Zone:

There are three main steps to setting up a Reading Zone:

  1. Enter the text you wish to display to participants into the Zone as Content.
  2. Choose an operation mode (Paced or Selfpaced) for the Reading Zone.
  3. Set up the remaining configuration settings to determine how the text content is displayed to participants.

1) Entering text content

  • Edit the Zone content to set the text content for the Reading Zone.
  • Separate each text segment using the Pipe symbol (|) as the delimiter.

Note: We recommend making the Reading Zone as large as possible. The text content will wrap within the Reading Zone automatically. This means long sentences will display across multiple lines, respecting the boundaries and size of the Zone. If you wish to display a medium - long length sentences across a single line you will need to maximise the width of your Reading Zone.

2) Choosing the operation mode

  • Edit Configuration Setting-1 to set the operation mode of the Reading Zone. Type either 'Paced' or 'Selfpaced' to set the mode.
  • Choose 'Paced' mode if you wish your text content to be displayed at a fixed pace with progression handled automatically by the Reading Zone.
  • Choose 'Selfpaced' mode if you wish your participants to control the pace at which each text segment is presented.

Note: If no mode is set the Reading Zone will default to 'Paced' mode.

View the image examples and configuration settings sections below for more details on the opeation mode.

3) Configuration settings The Reading Zone, like the majority of other multi-mode zones has a set of general configuration settings which are shared by both modes (Paced and Selfpaced). However, the Reading Zone also includes a set of specific configuration settings which are unique to each operation mode.

  • Settings which are only applicable to Paced mode can be found under the section 'Paced Settings'.
  • Settings which are only applicable to Selfpaced mode can be found under the section 'Self-paced Settings'. You only need configure the settings which are relevant to the mode you are using. If you configure settings for an operation mode you have not chosen they will have no effect.

View the image examples and configuration settings sections below for more details on all of the settings.


Use Case: The Reading Zone is typically used to conduct experiments involving paced and self-paced reading tasks. The Reading Zone will also be extremely useful in any task where you wish to procedurally display text, at either a controlled rate, or at a rate dictated by the participant.

1) Pacing is (Paced or Selfpaced).

Setting (Paced or Selfpaced): Type either 'Paced' or 'Selfpaced' to choose the operation mode for the Zone. Default = Paced; Each segment of the text content will be presented sequentially at an even rate.

Paced: In Paced mode the Reading Zone will automatically display each text segment, sequentially, at an even rate which is determined by the Paced Settings: Configuration Setting-6. In this mode the participant does not need to interact with the Reading Zone. The Reading Zone functions purely to control the style and how quickly the content is presented.

Selfpaced: In Selfpaced mode the Reading Zone will only display the next text segment upon receiving a trigger input from the participant. For the Selfpaced mode to function it is mandatory that Selfpaced Setting: Configuration Setting-7 - the trigger input method - is also set.

Note: If Selfpaced mode is chosen and no trigger method is configured the participant will not be able to interact with the Reading Zone nor advance the task.

Selfpaced mode has additional configuration settings which can be found under the Selfpaced Settings section.


2) Presentation is (Progressive or Isolation).

Setting (Progressive or Isolation): Type either 'Progressive' or 'Isolation' to choose the presentation style for the Zone. Default = Progressive; Text segments are presented sequentially in a cumulative fashion.

Progressive: Each text segment is presented sequentially in a cumulative fashion such that when the last text segment is reached the full text content (i.e. all text segments) will be visible on the screen.

Use this method when you wish to build up a sentence word by word using the Reading Zone.

Isolation: Each text segment is presented individually one segment at a time. When the last text segment is reached only the last text segment will be visible on the screen.

Use this method when you wish to show a sentence one word at a time; where each word is shown in isolation from the rest of the sentence.


3) Content location is (Centre or Relative).

Setting (Centre or Relative): Type either 'Centre' or 'Relative' to choose how content should be positioned upon presentation. Default = Centre; Visible content will always be presented in the centre of the Reading Zone.

Centre: When presenting the text segments all visible content will always be presented as centred within the Reading Zone.

Relative: When presenting the text segments each visible text segment will be presented at the position it occupies within the full text Content. With certain zone configurations this will appear as text content moving across the screen from left to right.

This setting is best demonstrated by viewing the task examples below.


4) Content mask is (On or Off).

Setting (On or Off): Type either 'On' or 'Off' to choose whether to mask content or not. Default = Off; content will not be masked.

On: Content will be masked. Only visible content will appear non-masked. Which content counts as 'visible' will depend upon the setup of Configuration Setting-2.

Note: Configuration Setting-3 must be set to 'Relative' for Masking to be applied to the text Content.

Off: Regardless of other Zone Configuration Settings content will not be masked.


5) Reaction time metric is (Individual or Cumulative).

Setting (Individual or Cumulative): Type either 'Individual' or 'Cumulative' to choose the operation mode for the Zone. Default = Individual; Reaction time recorded for each text segment will represent the total time that the text segment was presented on the screen.

Individual: Each text segment will produce a single row in your metrics. For each text segment, the reaction time that is recorded, represents the time that the individual text segment was visible for. For the full series of metrics produced by the Reading Zone, reaction times will appear as a list of unique individual reaction times one for each text segment

Cumulative: The recorded reaction time will be relative to the start of the screen. Each text segment will produce a single row in your metrics. The reaction time that is recorded, for each text segment, represents the time taken from the start of the screen. For the full series of metrics produced by the Reading Zone, reaction times will appear a cumulative list of reaction times; with the reaction time increasing with each successive text segment.


Paced settings


6) If Paced, content appears every (number) ms.

Setting (number): Type a time, as a number of milliseconds (ms), to represent the total duration each text segment should be presented for. Default = 500ms; Each text segment will be presented for 500 ms.

If set, each text segment will be presented for the specified amount of time. When the specified duration is reached the next text segment is shown. If there are no more text segments left to be presented Gorilla will auto advance the participant to the next screen in the task.


Selfpaced settings


7) If Selfpaced, content is triggered by (Keyboard or Mouse).

Setting (Keyboard or Mouse): Type either 'Keyboard' or 'Mouse' to choose the trigger method for selfpaced mode. Default = None.

Note: If Selfpaced mode is chosen it is mandatory that this setting is configured. If Selfpaced mode is chosen and no trigger method is configured the participant will not be able to use the Reading Zone nor advance the task.

Keyboard: If Keyboard is selected, the participant can trigger the presentation of each text segment by using the Space Bar Key on their keyboard. Each press of the Spacebar Key will trigger the progression of the text content presentation and advance the task.

Mouse: If Mouse is selected, the participant can trigger the presentation of each text segment by using a Left Mouse Button Click. Each press of the Left Mouse Button will trigger the progression of the text content presentation and advance the task. For Mac users clicking the Mouse button will trigger the progression of the text content presentation and advance the task.


8) If Selfpaced, set minimum content duration of (number) ms.

Setting (number): Type a time, as a number of milliseconds (ms), for the minimum length of time a text segment should be displayed for. Default = None; No minimum content duration is set. The next text segment will be displayed immediately when triggered by the participant.

If set; the minimum content duration ensures each text segment is seen by the participant for a specified minimum amount of time.


9) If Selfpaced, set maximum content duration of (number) ms.

Setting (number): Type a time, as a number of milliseconds (ms), for the maximum length of time a text segment should be displayed for. Default = None; No maximum content duration is set. The next text segment will be displayed only if triggered by the participant.

If set; the maximum content duration ensures each text segment is only seen by the participant for a specified maximum amount of time. If the participant does not interact with the Reading Zone before the maximum amount of time has elapsed the next text segment will be displayed automatically.

The maximum duration adds back in a pacing element to a Selfpaced task set up - allowing the creation of pseudo-paced tasks.

You can try out the Reading Zone as a participant by taking our Reading Zone Demo here: Ty out the Demo Now!


Canvas Painting Zone


Canvas Painting Zone Icon:

The Canvas Painting Zone adds an interactive image zone to your screen which allows participants to paint over the provided image using a selection of colours of your choice.

Note: This feature is currently in Closed-Beta, meaning it is still under development. If you would like to use this zone for your experiment, you can recieve access via our contact form.

Try out the link below to see this Zone in action:


View a Demo


How it works:

The Canvas Painting Zone is an advanced zone which differs from its simpler counterpart the Click Painting Zone in 3 ways:

  1. The Canvas Painting Zone does not produce any coordinate nor reaction time metrics.
  2. The result of the participants Canvas Painting will be available to download in the form of a .png image file.
  3. You must use an Advancement Zone (such as a continue button, timelimit or active response zone) on the same screen as the Canvas Painting Zone.

Under the bonnet the Canvas Painting Zone utilises HTML5 Canvas elements to create the interactive zone for your participants to draw on using their mouse.

The Canvas Painting Zone presents your uploaded image to the participants along with a panel of colour options below. The participant is then free to draw over the image using any of the provided colours.

Once the screen advances the entire canvas will be saved and uploaded to our servers as an image file.

Note: When previewing a task, your additional files can be accessed via a URL placed in the metrics. When running a full experiment, all of the additional files can be accessed from the 'Manage Experiment Data' button on your Experiments Data page. The zip folder with all your metrics data will include an 'Uploads' folder, containing all of your additional files.


Canvas Painting Zone Set up:

  1. Place the Canvas Painting Zone on your screen along with an Advancement Zone.
  2. Edit the Zone content to set the Image you wish participants to paint on.
  3. Upload the image in the Stimuli Tab of the Task Builder.
  4. Edit the zones configuration settings to provide a selection of colours for your participants to use and set the paint brush size.

Supported Image types: .png, .jpg, and .jpeg. Remember you will need to upload your image stimuli in the Stimuli Tab for your task.

Canvas Painting Presentation Size: Just like the Image Zone, the Canvas Painting Zone requires an uploaded image to function. The size of the painting area will be the same size as the uploaded image.

If the uploaded image is larger than the size of the zone itself it will be resized to fit the zone, while maintaining the exact aspect ratio. These are the exact same rules that apply to Images uploaded to an Image Zone, for full details of all the resizing rules and behaviour please refer to the Image Zone documentation.

If your canvas appears too small: We recommend first to maximise the size of your Canvas Painting Zone within your screen's design. Then check the dimensions (width and height) of your uploaded image - increase the size of the original image and you will see your canvas size increase.

Using a Blank Canvas: If you wish to present a blank canvas to the participant, simply upload a blank, white or plain coloured image to the Canvas Painting Zone.


Use Case:

Use the Canvas Painting Zone when you wish your participants to highlight, indicate or otherwise free draw over a specified image.

For Example:

  • Body maps: Where do you feel this emotion in your body?
  • Theory of mind: Where does Jane think the box is?
  • Symmetry: Draw the lines of symmetry over this image.

1 ) Prefix filename with (text) for captured data.

Setting (text): Type a name to identify the canvas_painting image file. Default prefix: Canvas_paint The full default file name will be: task-NODEKEY-XXXXXX-Canvas_paint-A-B

If set to any text string; The text highlighted in bold, in the default filenames above, will be replaced with your choosen filename.

Note: only use alpha-numeric characters in your file names. Do not use special characters as this could prevent you from retrieving data files.

You will likely wish to use this setting with spreadsheet 'source' if you wish to uniquely identify your canvas painting images on a 'per-trial' basis.

Review the metrics section above for details on the default file name structure.


2) Paint brush size (in pixels): (number).

Setting (number): Type a number to set the pixel size of the paint brush. Default = 20; By default, the paint bush size will be a 20 x 20 pixel square.

If set to any number, the paint brush size will be created with a length and height matching the set value. i.e. if set to 10 the brush size will be a 10 x 10 pixel square, if set to 25 the brush size will be a 25 x 25 pixel square.


3) Colour options (Max 15): (RGB colour value).

Setting (RGB colour value): Type up to 15 RGB colour values separated by semicolons. Default = 0,255,0; (green); By default, the participant will be presented with one colour option for the brush which is RGB value '0,255,0;' representing the colour green.

Enter an individual RGB colour as three numbers separated by commas (e.g. 128,128,128;).

You can set up to 15 individual colours to form a colour palette for your participant to select from. Separate multiple colours by semi-colons. The colour palette will appear at the bottom of the Canvas, allowing participants to select the colour they wish to paint with.

See the image example above for more details on setting multiple colours including how this appears to the participant.

This feature is currently in Closed-Beta, meaning it is still under development. If you would like to use this zone for your experiment, you can recieve access via our contact form.

You can try out the Canvas Painting Zone as a participant by taking our Canvas Painting Zone Demo here: Try our Demo!


Eye Tracking Zone


The Eye Tracking Zone allows you to add basic eye tracking functionality to your task by utilising a participant's webcam.

Under the bonnet the Eye Tracking Zone utilises Webgazer.js. It works by using a participant's webcam to detect a participant's face. It then uses prediction models to infer the participant eye-gaze locations on the screen in real time. Please see this page for the Webgazer teams advice on how to cite them.

Try out the link below to see this Zone in action:


View a Demo


Notes

This feature is currently in Closed-Beta, meaning it is still under development. If you would like to use this zone for your experiment, you can recieve access via our contact form.

The current zone does not provide data which you can reliably detect fixations, saccades, scan paths and blinks with. Instead it provides estimates of gaze locations, with an associated confidence -- these can be used to create heatmaps of images, or percentage occupancy of areas of interest.

Note on ethics: the webcam images used in the eye tracking zone are translated into coordinates on the participant's computer. All Gorilla recieves is the coordinate data; the webcam images are only used to determine the coordinate data and are not saved.

Please note we are unable to give support for data analysis, beyond identifying what the output data represents.


Differences

It is important to note that the Eye Tracking Zone differs from standard zones in 4 ways:

  1. The Zone will need to be set up across multiple screens. Every screen on which you wish to detect a participant's gaze needs to include the Eye Tracking Zone.
  2. You can only use 1 Eye Tracking Zone on a screen.
  3. How the Zone functions changes depending upon which operation mode (calibrate or collect) is chosen.
  4. How and when the Zone records and stores metrics depends up on which recording configuration setting is chosen.

Setup

The Eye Tracking Zone has two modes of operation:

  1. Calibrate Mode
  2. Collect Mode

Both modes should be used at least once within your task.

For best results we recommend repeating the calibrate mode approximately every 10 trials or 3 minutes. This will help you to account for participant 'head-drift' or body repositioning which could affect gaze detection performance.


Calibrate

To set up the Eye Tracking Zone in Calibrate mode:

  1. Place the Eye Tracking Zone on its own Separate Screen.
  2. Set the Eye Tracking Zone Configuration to 'calibrate'
  3. Edit the Zone Layout to maximise the Zone size to equal the full size of screen.
  4. Do not include any advancement zones (e.g. Continue buttons, Time-limits or Response Zones) on the same screen.

The default number of calibration points is 5, but you have the option to change this to 9 in the zone configuration settings.

The zone calibration also includes the option to retry calibration if the calibration is considered failed. Calibration has two stages: initial calibration, followed by validation. In the validation stage, the eye tracking zone tests the predictions it's making. If it finds that its predictions for a number (set by you) of calibration points are closer to a different calibration point than to the intended point, the calibration will be considered failed and will be retried.

At the end of your calibrate screen, you have the option to be shown a validation plot, like the one in the image below. The squares represent the points used for calibration, and the circles represent the variation in the detected gaze location for each point. The calibration data for each participant will be included in your metrics, and you can use it to get an idea of the accuracy and reliability of your eye tracking data.


Collection

To set up the Eye Tracking Zone in Collect mode:

  1. Place the Eye Tracking Zone on each of your Task Screens where you wish to use eye tracking.
  1. Set the Eye Tracking Zone Configuration to 'collect'

    Note: In Collect mode the Size and Position of the Eye Tracking Zone do not matter. Place the Eye Tracking Zone anywhere on your Task Screens.

  1. Decide whether you would like to collect detailed eyetracking data. By default, the eye tracking zone will give you information on the absolute and percentage time the participants' gaze was in each half and each quadrant of the task screen. This will be included in your main task data file. If you want access to the full coordinate data, use the Advanced Data Collection setting to specify this.
  1. Edit the Configuration Setting-5 to set the Eye Tracking Zone recording criteria.
  • If you wish to continue detecting a participant's gaze on the next screen, and do not want the eye tracking data for this screen to be in a separate metrics file: Set this to 1.
  • If the screen is the last screen of an individual trial: set this to 0. This will tell the Eye Tracking Zone to create a single data file containing all eye tracking metrics collected so far for your trial.
  1. Edit the Zone names of the other zones you are including in your task. Typically, these ROI will be stimuli zones or response Zones. Your metrics file will include the x and y coordinates of all the zones on each screen, so naming ROI will allow you to easily identify the zones you are interested in.

    Note: When updating Zone names, you may only use alpha-numeric characters.

Note: When previewing a task, your additional files can be accessed via a URL placed in the metrics. When running a full experiment, all of the additional files can be accessed from the 'Manage Experiment Data' button on your Experiments Data page. The zip folder with all your metrics data will include an 'Uploads' folder, containing all of your additional files.


Settings

1) Use the (calibrate or collect) mode (choose 'calibrate' or 'collect')

Setting (calibrate or collect): Type either 'calibrate' or 'collect' to choose the operation mode for the Zone. Default = calibrate; If no mode is set the Eye Tracking Zone will default to the 'calibrate' mode.

Calibrate: In calibrate mode the Eye Tracking Zone will perform a routine calibration and validation test. Note Calibration mode requires the Eye Tracking Zone to take up the full size of the Screen - see image example above.

Collect: In collect mode the Eye Tracking Zone will detect a participant's gaze and return the screen coordinates of the participants predicted gaze to the Eye Tracking metrics.


2) If (1 or 0) show the dot while calibrating. This is useful for testing, but not recommended for participants. Use 1 to show the dot, otherwise 0. [Calibrate Mode ONLY]

Setting (1 or 0): Type either 1 or 0 to select if a 'predicted gaze' dot should be shown during calibration mode. Default = 0; By default, the Eye Tracking Zone will not show a red dot during calibration mode.

If set to 1; The Eye Tracking Zone will show a red dot during calibration mode which represents the position of the 'predicted gaze' of the participant.

If set to 0; The Eye Tracking Zone will not show a red dot during calibration.

3) If (1 or 0) show the validation plot after calibrating. This is useful for testing, but not recommended for participants. Use 1 to show the plot, otherwise 0. [Calibrate Mode ONLY]

Setting (1 or 0): Type either 1 or 0 to select if the Eye Tracking Zone should show an additional screen, containing calibration and validation results, after calibration has completed. Default = 0; By default, the Eye Tracking Zone will automatically advance to the next Screen/Display in your task, once the calibration has completed.

If set to 1; The Eye Tracking Zone will add an additional static screen at the end of the calibration. This screen will contain a visual representation of the eye tracking calibration and validation results. The screen will appear directly after calibration has completed. It will present with an 'End Calibration' button which allows the participant/researcher to advance to the next screen manually in their own time.

If set to 0; The Eye Tracking Zone will not present with the additional calibration/validation results screen. Instead, once the calibration has been completed the participant will be automatically advanced to the next Screen/Display in your task.

We recommend including a calibration 'finished' screen for your participants to reminds them to limit head movement as much as possible for the proceeding trials. This also acts to let them know the eye tracking calibration stage has finished.


4) Prefix filename with (text) for captured data

Setting (text): Type a name to identify the eye tracking data file.

Defaults: In calibrate mode the default file name will be: task-NODEKEY-XXXXXX-eyetracking_calibration-A-B

In collect mode the default file name will be: task-NODEKEY-XXXXXX-eyetracking_collection-A-B

If set to any text string; The text highlighted in bold, in the default filenames above, will be replaced with your choosen filename.

Note: only use alpha-numeric characters in your file names. Do not use special characters as this could prevent you from retrieving data files.

You will likely wish to use this setting with spreadsheet 'source' if you wish to uniquely identify your eye tracking data files on a 'per-trial' basis.

Review the metrics section above for details on the default file name structure.


5) If (1 or 0) continue recording after the end of this screen. Only set this if you are recording data across multiple screens, and ensure that the last screen does not have this set. Use 1 to continue recording and 0 to stop recording.

Setting (1 or 0): Type either 1 or 0 to select if the Eye Tracking Zone should continue recording. Default = 0; By default, the Eye Tracking Zone will stop collecting data when the screen is advanced. Producing a unique Eye Tracking data file for this screen.

If set to 1; The Eye Tracking Zone will continue to poll and record the gaze of the participant between screens containing an Eye Tracking Zone.

If set to 0; The Eye Tracking Zone will stop recording once the screen has been advanced and a unique metrics file containing the Eye Tracking data will be created.


This zone can be localised. For more information visit our Localisation guide.



Gabor Patch Zone


Gabor Patch Zone Icon:

The Gabor Patch Zone is an advanced zone which generates a gabor patch on the screen for your participant following the criteria set out in the zones configuration settings and the values obtained from a Screen Calibration Zone.

Note: This feature is currently in Closed-Beta, meaning it is still under development. If you would like to use this zone for your experiment, you can recieve access via our contact form.

Try out the link below to see this Zone in action:


View a Demo


How it works: The Gabor Patch Zone is unique content Zone that differs from other zones in that it is dependant on the use of another zone: The Screen Calibration Zone.

It is Mandatory to use the Screen Calibration Zone at least once in the same task as the Gabor Patch. And the Screen Calibration Zone must be presented to the participant before the Gabor Patch Zone is reached.

The Gabor Patch Zone uses information generated about visual degrees by the Screen Calibration Zone and the internal Gabor Patch configuration settings to generate and present a Gabor Patch to the participants.

The mandatory use of the Screen Calibration Zone allows the Gabor Patch to be accurately generated in the visual degrees on the user's screen. If the participant does not interact with the Screen Calibration Zone prior to meeting the Gabor Patch Zone, a Gabor Patch will not be generated.


Setting up a Gabor Patch Zone:

First you must add a Screen Calibration Zone to your Task Strucure. You can read more about setting up a Screen Calibration Zone here. Here we will mention only the specifics related to setting up a Gabor Patch Zone.

  1. Add a Screen Calibration Zone into your Task Structure.
  2. Ensure the Screen Calibration Zone advanced setting ('Screen distance calculation') is configured to 'On'.
  3. Ensure the Display containing your Screen Calibration Zone appears in your spreadsheet before any of your Displays containing a Gabor Patch.

Once the Screen Calibration Zone is set up correctly you can now add and set up your Gabor Patch Zones and see them working straight away.

  1. Add a Gabor Patch Zone onto one of your screens, you can find this under the 'Advanced' section of the Add Zone menu. (Note: We recommend making the Zone as large as possible.)
  2. Include some form of 'advancement' zone on the same screen as your Gabor Patch Zone. (Note: You should now be able to preview your Gabor Patch and see it working with in the default configuration.)
  3. Configure the 'Animation type' (Configuration Setting-1) of the Gabor Patch Zone.

There are three types of patch to choose from:

  • Static - a static image with a fixed orientation and phase.
  • Rotation - the patch has a cycling orientation, so the patch rotates in place.
  • Phase - the patch’s phase changes, so the lines appear to move in a single direction.
  1. Next configure the general configuration settings: For all patch types there are 6 general configuration settings, if no settings are configured the default values will be used. See the configuration settings section below for the details.

  2. Finally, if you have choosen a patch type of either 'Rotation' or 'Phase', there are 3 additional configuration settings. These are found under the Rotating and Phase Specific Settings section. Press the + show button to expand and edit these options.

Use Case: Gabor patches or Gabor features are a great way to present various orientations to your research participants.

These stimuli are often used for visual perception research, where the standard for presenting stimuli is to use ‘visual degrees’ or ‘visual angle’ as a measurement of size.


Note the Gabor Patch Zone does not produce any unique Metrics

1) Animation type is (choose 'Static', 'Rotation' or 'Phase')

Setting (Static or Rotation or Phase): Type either 'Static', 'Rotation' or 'Phase' to choose the Patch Type for the Zone. Default = Static; The Gabor Patch type produced will be a static image with a fixed orientation and phase.

Static - This type of Gabor Patch produces a static image with a fixed orientation and phase. Rotation - This type of Gabor Patch produces an image with a cycling orientation, so the patch rotates in place. Phase - This type of Gabor Patch produces an image where the phase changes, so the lines appear to move in a single direction.


2) Spatial frequency is (number) cycles per degree

Setting (number): Type an integer (whole number) to represent the number of cycles per visual degree on screen. Default = 1; represents a spatial frequency of 1 cycle per visual degree.

This determines the number of cycles per visual degree on screen. The number of cycles per visual degree determines how many oriented lines will be visible within the patch, and the width of these lines. The higher this value, the more lines are displayed and the more compact they will be.

You can choose any positive integer for this (so 1 not 1.2 or 0.8) if you do use a decimal number it will be rounded down to an integer.


3) Size is (number) visual degrees.

Setting (number): Type a whole number to set size of the patch in visual degrees. Default = 15; The Gabor patch will be displayed as a square of size 15 VD (visual degrees).

This determines the size, in visual degrees, that the Gabor Patch will appear on the participants screen. Note Gabor Patches will always be square so the size determines both it's height and width.


4) Gaussian SD is (number) visual degrees.

Setting (number): Type a number to set the size of the Gaussian Window in visual degrees. Default = 2; The Standard Deviation of the Gaussian Window imposed over the patch will be 2 Visual Degrees.

This setting controls the size and 'blurriness' of the Gaussian 'window' imposed over the patch. This window appears as a circular view port with a blurry edge.

The standard deviation of this window (sized in visual degrees) determines how large and blury the window's edge will be - a higher number will lead to a larger and more blurred edge.

Note the minimum window that can be imposed is 1 VD.


5) Background RGB is (RGB color code).

Setting (number): Enter a background colour as a RGB color code. Default = 128,128,128; The Gabor patch background colour will be Grey as determined by the RGB color code 128,128,128.

This determines the background colour for the Gabor Patch which will appear behind the Gabor Patch.

You must set the color using an RGB color code where each Red, Green and Blue value is separated using a comma (','). (e.g. 128,128,128)

Note that an individual RGB value will always be a single number between 0 and 255.


6) Orientation is (number) degrees.

Setting (number): Type a number of degrees to determine the orientation of the patch lines. Default = 90; The orientation of the lines in the Gabor Patch will be at 90 degrees or vertical.

This determines the orientation of the Gabor Patch, in degrees. This is most noticible as determining the initial direction the lines of Gabor Patch appear to be orientated.


Rotating and Phase specific settings


7) Rotation Speed is (number) degrees per second. [Rotation Patch Type Only]

Setting (number): Type a number of angular degrees for the rotation speed. Default = 10; The patch will rotate at 10 angular degrees per second.

Rotation Speed determines how fast the patch rotates. The number set represents the Rotation Speed in angular degrees per second. Or else described as the angle the patch will change per second.

The higher the Rotation Speed the faster the patch will appear to rotate. Note Patches rotate about their center point.


8) Phase speed is (number) phase fractions per second. [Phase Patch Type Only]

Setting (number): Type a number of phase fractions for the phase speed. Default = 1; The patch will move at a rate of 1 phase fraction per second.

The Phase speed determines how fast the patch moves. The number set represents the Phase Speed in phase fractions per second. Or else descirbed as the number of cycles (or lines) that will move per second.

The higher the Phase Speed the faster the lines in the patch will appear to move.


9) Direction is (1 or 0).

Setting (1 or 0): Choose 1 or 0 to set the Rotation or Phase direction. Default = 1; The patch will rotate in an anti-clockwise (or right-phase) direction.

Set to 0 for clockwise (rotation) or left (phase). Set to 1 for anticlockwise (rotation) or right (phase).


MouseView Zone


Note: This feature is currently in Closed-Beta, meaning it is still under development. If you would like to use this zone for your experiment, you can recieve access via our contact form.


The MouseView Zone allows you to track participant's mouse movement on the screen using a cursor-directed aperture.

Use case: MouseView Zone can be used for attention tracking in web-based experiments as an alternative to the Eye Tracking.

You can read more about MouseView from their official website here: https://www.mouseview.org/


Try out a Mouse View Zone Example


Setting up the MouseView Zone:

  1. Upload a background stimuli to your screen then place the MouseView Zone on each of your Task Screens where you wish to use mouse view.

  2. Edit Configuration settings of the MouseView Zone - see details below.

MouseView

1) Use the (setting) mode.

Setting (record or upload : Type either 'record' or 'upload' to choose the operation mode for the Zone. Default = record; If no mode is set the MouseView Zone will default to the 'record' mode.

Record: In record mode the MouseView Zone will record participant video and return the recorded video to the MouseView Zone Metrics.

Upload: You only need to use upload if you want to upload on at, say, the end of a task or end of a block. Otherwise, use the Continue Recording setting instead.


2) Prefix filename with (setting) for captured data

Setting (text): Type a name to identify the mouse tracking data file.

Default = mouseview; By default, the MouseView Zone will produce data with the filename mouseview-1-3, or similar.

When set to any text, this changes the filename of the MouseView data i.e. if set to 'MouseTask', the file might be named 'MouseTask-1-3'.

Note: Only use alpha-numeric characters in your file names. Do not use special characters as this could prevent you from retrieving data files.


3) If (setting) continue recording after the end of this screen.

Only set this if you are recording data across multiple screens, and ensure that the last screen does not have this set. Choose 1 (continue recording) or 0 (stop recording). Default: 0


Mouseview specific settings


1) Overlay Colour: (setting).

Enter the colour for the overlay as a colour name or hexcode. Default: black


2) Overlay Alpha: (setting).

Enter the alpha (transparency) value for the overlay as a float between 0.0 and 1.0. Default: 0.8


3) Overlay Gaussian Blur: (setting) pixels.

Enter the standard deviation, as a number of pixels, for the Gaussian Blur. Higher numbers = more blur. Default: 20


4) Aperture Size: (setting) % of screen space.

Enter the size of the viewing aperture as a number representing percentage of screen. Default: 5 (i.e. 5%)


Click to view an Example of a simple Task which makes use of the MouseView Zone.


Screen Calibration Zone


This zone allows you to ask your participants to calibrate their monitor, permitting stimuli to be presented in either Centimetres or Visual Angle (degrees).

It achieves this by asking participants to scale an image of a bank card to the size of a real bank card held up against the screen. It also can optionally ask them to enter their approximate distance from the screen in CMs.

Note: This feature is currently in Closed-Beta, meaning it is still under development. If you would like to use this zone for your experiment, you can recieve access via our contact form.

Adding the zone

Before presenting adjusted sizes, you must first have your participant view the calibration zone. This is done in the Task Builder.

  1. Select or create the Screen you would like the calibration zone to be in.
  2. Click Edit Layout -> Add Zone
  3. Click on the silhouette of the zone
  4. In the popup select the ‘Advanced’ tab
  5. Select ‘Screen Calibration’ and press ‘OK’
  6. Press ‘Done’

Once the zone is added to a screen, you will be able to see some settings under ‘Advanced Settings’

  • Screen distance calculation: Allows you to prompt the user to enter the distance from the screen they are sitting
    • This feature permits presentation in approximate visual angle, without this being set to ‘On’ using visual angle will not be accurate

Presenting Images

The next step is to set the presentation size of your images. You are able to do this in the ‘Advanced Settings’ created on any screen with an image. You can set the image Width to CMs or to visual degrees. This can be entered at the screen as static content, or can be taken from Spreadsheet or Manipulation values.


This zone can be localised. For more information visit our Localisation guide.


Video Recording Zone


This zone is in BETA. Use at your own risk and please report any issues promptly.

Warning

KNOWN ISSUES

June 2020 (ISSUE): There is a lag time between Gorilla requesting the camera to start recording and the camera beginning data collection. This can cause the beginning of a participants video response to be cut off. In the short term, if your task requires participants to respond to a visual stimuli presented on the screen, you should delay the onset of that stimuli by 500-1000ms. This can usually only be achieved using script (which, at the moment, is available via the support desk on request). If participants respond to an audio stimuli, we recommend adding some empty space at the beginning of the audio track.

June 2020 (ISSUE): If a Video Recording is ended by another zone (Timelimit(Screen), Response Button Text etc.) rather than the Video Recording zone itself, this can cause the end of the Video stream to be lost. In the short term, if your task requires that another zone end the screen, you should delay the effect of that zone by 500-1000ms, to allow time for the Video Stream to clear. This can usually only be achieved using script. You can find two examples of this here and here

(DEV UPDATE): Actions are being taken during the course of the next few months to reduce the impact of these two issues, hopefully to the point that additional scripts will no longer be necessary.


The Video recording zone allows you to create video files of your participants, via their web cams.

Note: This feature is currently in Closed-Beta, meaning it is still under development. If you would like to use this zone for your experiment, you can recieve access via our contact form.

You can choose to record video with or without audio. You can also choose whether to record automatically on screen start, or to allow the participant to manually start the recording.

Participants will be asked for permission to access their webcam the first time either the Video Recording Zone or the Video Feed Zone is used in an experiment. We recommend first using the zone in its test setting, so participants can check that their webcam is working correctly.

How it works: The Video 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 needs to include an Video Recording Zone.
  3. You can only use 1 Video Recording Zone on a screen.
  4. Each video recording is saved as a separate file which is stored and accessed separately.

Note: When previewing a task, your additional files can be accessed via a URL placed in the metrics. When running a full experiment, all of the additional files can be accessed from the 'Manage Experiment Data' button on your Experiments Data page. The zip folder with all your metrics data will include an 'Uploads' folder, containing all of your additional files.


Setting up the Video Recording Zone: The Video Recording Zone has two modes of operation:

  1. Test Mode
  2. Record Mode

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

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

Note that 'test' mode records no metrics, embedded data nor saves the video recording. Instead this mode allows the participant to instantly play back their recorded video in order to make sure their video can be seen and their webcam is working. Configuration Setting-2 gives you the option to record (and so also test for) audio.

  1. Set the Video Recording Zone Configuration Setting-1 to 'test'
  2. (Optional) We recommend limiting the maximum recording time (Configuration Setting-5) for the test mode to 3 seconds (3000ms).
  3. No other configuration settings are required or applicable to the Video Recording Zone set to 'test' mode.
  4. 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 video recording is working correctly with their webcam before advancing with your task.

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

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

1) Use the (test or record) mode (choose 'test' or 'record')

Setting (test or record): Type either 'test' or 'record' to choose the operation mode for the Zone. Default = test; If no mode is set the Video Recording Zone will default to the 'test' mode.

Test: In test mode the Video Recording Zone will record video, and allow the participant to replay the video to check that their webcam is functioning correctly. Test mode records no metrics.

Record: In record mode the Video Recording Zone will record participant video and return the recorded video to the Video Recording Zone Metrics.


2) If (1 or 0) record audio as well as video [record mode ONLY]

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

If set to 1; The Video Recording Zone will record audio as well as video.

If set to 0; The Video Recording Zone will only record video


3) If (1 or 0) automatically begin recording on screen start. [record mode ONLY]

Setting (1 or 0): Type either 1 to turn the setting on, or 0 to turn the setting off. Default = 0; By default, the Video Recording Zone will begin recording when the 'Start Recording' is pressed.

If set to 1; The Video Recording Zone will begin recording when the screen starts.

If set to 0; The Video Recording Zone will only begin recording when the 'Start Recording' is pressed, and stop recording when a 'Stop recording' button is pressed.

Note: If this setting is set to 1, and there is no continue button or active response zone on screen, the screen will only progress when the max recording time is reached.


4) If (1 or 0) automatically advance to the next screen when recording is complete. [record mode ONLY]

Setting (1 or 0): Type either 1 to turn the setting on, or 0 to turn the setting off. Default = 1; By default, the Video Recording Zone will automatically advance to the next screen when either the recording is complete or the maximum recording time is reached (Configuration Setting-5).

Note: When set to 1, you do not need to include any other Advancement Zones such as Timelimit (Screen) Zones. Instead you can set a maximum record length. If either the participant finishes talking or the maximum record length is reached the Video Recording Zone will stop recording and the screen will advance automatically.

If set to 0; The screen will not advance when the participants has finished recording nor when the maximum recording time has been reached. Instead you must also include an advancement zone (e.g. Continue Button or Timelimit (screen) Zone) or response zone on the same screen so that participants can advance the screen manually.

5) Prefix filename with (text) for captured video [record mode ONLY]

Setting (text): Type a name to identify the recorded video file. Default = videoFile; By default, the Video Recording Zone will produce an video file with the filename videoFile-1-3, or similar.

If set to any text string; this changes the filename of the recorded video file e.g. if set to TaskVideo, the file will be named TaskVideo-1-3.

Note: only use alpha-numeric characters in your file names. Do not use special characters as this could prevent you from retrieving data files.

You will likely wish to use this setting with spreadsheet 'source' if you wish to uniquely identify your recorded video files on a 'per-trial' basis.

Review the metrics section above for details on the default file name structure.


6) Set max recording time to (number) ms (Maximum: 120000 ms)

Setting (number): Type a duration in milliseconds (ms) to set the maximum recording time. Default = 120000; By default, the maximum recording time equals the allowed maximum of 120000 milliseconds (2 minutes).

When set, this restricts the length of an video recording to the number of milliseconds you enter. Once the maximum recording time has been reached the Video Recording Zone will stop recording. Maximum possible recording length is 120000 ms (2 minutes).

This setting is particularly useful when you have set the screen to auto-record and auto-advance, as it stops the recording at the duration set allowing the screen to progress at a set time.


6) Store URL as embedded data called (text) [record mode ONLY]

Setting (text): Type a key-name for the embedded data. Default = none; No key is created, no embedded data is stored.

If set to any text-string, this creates an embedded data key with the given name, this key will store the recorded video.

You can then retrieve this video file later using this key name. Enter your key name as embedded data - e.g. $${myEmbeddedDataKeyName} - into a Video Zone to replay the recorded video back to the participant.

Note: Video embedded data cannot be retrieved on a screen directly after it is recorded. There must be an intermediary screen of at least 550ms.

Examples will be coming soon!


This zone can be localised. For more information visit our Localisation guide.


Video Feed Zone


The Video Feed Zone allows you present participants with the feed from their webcam and to capture still images using the webcam.

Note: This feature is currently in Closed-Beta, meaning it is still under development. If you would like to use this zone for your experiment, you can recieve access via our contact form.

This zone can be used in an experiment where you want your participants to believe they are being observed, without actually capturing video recordings.

Participants will be asked for permission to access their webcam the first time either the Video Recording Zone or the Video Feed Zone is used in an experiment.

Examples and further information on zone settings will be coming soon!


This zone can be localised. For more information visit our Localisation guide.


Auto Advance Zone


This functionality is deprecated and will not appear unless previously set in a task.

Please use the new Timelimit (screen) Zone


Set a timelimit for the screen. When this timelimit expires the task will advance to the next screen.

Automatically advance to the next screen after number milliseconds

The task will automatically advance to the next screen after the set time.

Embedded YouTube Zone


This functionality is deprecated and replaced with the updated Embedded YouTube Zone.

Please use the new Embedded YouTube Zone!


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

For the link you can use any of the following:

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

Embedded YouTube Zone Icon:

-- No Settings --

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


Audio Zone


This functionality is deprecated as of 13th April 2021.

Please use the Web Audio Zone!

Warning

The standard Audio zone has been formally deprecated! It can no longer be added to tasks. It will continue to function as-is in existing tasks. Please use the Web Audio zone instead!

The Web Audio zone uses a modern API, with better timing performance and improved response in the event of Autoplay Restrictions. The Web Audio zone has all the same features as the original Audio zone and should be used in it's place.


The Audio Zone allows you to add a single uploaded audio (sound) file to your screen.

Try out the link below to see this Zone in action:


Try out an Example


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:

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.

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.


This zone can be localised. For more information visit our Localisation guide.