Questionnaire Widgets


Welcome to the Questionnaire Widget Tooling Reference Guide.

Here you can find out information on how and when to use a particular Questionnaire Widgets. There are 20 Widgets available, browse the list in the menu on the left to find out more information about each one.

Questionnaires consist of blocks of Rich Text content (which can be a mixture of Markdown and/or HTML and Response widgets, which offer a range of ways for participants to be asked questions.

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

Tooling Reference Guide Format:

For each Questionnaire Widget listed you will find a description of the Widget and an image example. This will be followed by a live Demo of the Widget. Finally a configuration settings box (like the one below) will list and explain all available configuration settings for the selected Widget.

Most widgets offer three common configuration settings:

Configuration Settings:


This is the key that identifies this response in your metrics data. As the label or question for a widget may not directly identify which question it pertains to, the key gives you an opportunity to set the name of the response in your data.

Keys should be unique across the questionnaire - no two responses should have the same key. Keys will automatically be populated with generic values (response-1, response-2, ...) but you can change them to more meaningful values to make your data analysis easier.

Write to Embedded Data

If checked, the response to this question will also be written to the participant's embedded data, allowing you to retrieve and use it later in your experiment. To retrieve this data later within your experiment you must use the same key as specified above.

Allow Missing

If checked, this question does not need to be answered in order to progress. By default, all questionnaire questions need to be responded to, but you can elect to allow some questions to go unanswered.

Click the Tutorial icon to view a Tutorial which explains how to set up and use the selected Questionnaire Widget.

Click the Example icon to view an example of a Sample which makes use of the selected Questionnaire Widget.

Rich Text Widget

Rich Text Widgets are the most common widget in questionnaires. Rich Text widgets are designed to be the main content block of your questionnaire, with the other widgets specific to individual responses.

You can use Rich Text Widgets in your questionnaires to add instructions and information text, etc.

Rich Text Widgets support content written in Markdown and/or HTML. You can use them to add formatted text to your questionnaires, or embed your own HTML.

Configuration Settings:

-- No Settings --

Click to view a Tutorial of the Rich Text Widget.

Click to view a Classic 'Consent' Example which makes use of the Rich Text Widget.

Image Widget

You can use the Image Widget to add image content into your questionnaire. This may be useful for presenting stimuli or perhaps instructions that are in an image format.

Each Image Widget allows you to upload a single image, which is then hosted within Gorilla.

Configuration Settings:

Change (Button)

Click this button to bring up the Upload dialog-box, then browse for the file you wish to upload.

You will see a preview of the Image. Press the green 'Upload' button to complete the process. Otherwise select the orange 'Choose another' option to pick a different image.

Click to view a Tutorial of the Image Widget.

Click to view an Example of a Sample Project which makes use of the Image Widget.

Page Break Widget

A Page Break Widget allows you to separate out your questions across multiple pages.

All widgets after the page break will be shown on the next page.

As you can see in the example below. The Page Break Widget is a Layout Widget which means unlike other widgets the configuration options are not located in the Page Break Widget itself.

Locate the configurations settings in the questionnaire builder main Settings, under the Options Menu.