How to use the checkboxes block

When to use

Use the checkboxes block to let your respondents select multiple items from a list of checkbox choices you give them.

---

How to use

Add a new block to your form and then select the question type Checkboxes. You can now customize this block to your needs with the following features.

Basic features

Each question block has basic features to present the block the way you need, for example Name, Description and Help text. And most of the question blocks have common options, like the Required and Exportability options.

More information about these basic features can be found in the help article about our form builder.

Additional features

On top of those basic features, the checkbox block has the following advanced options:

• Limits

  By enabling the Limits feature, you can enter a minimum and maximum number of choices that respondents can select.

• Randomization

  By enabling the Randomization feature, the choices will be presented in a random order to your respondents (using Fisher–Yates shuffle).

• Labels

  By default the checkboxes will be marked as Checked or Not checked in your dataset (your results). By enabling the Labels feature you can overwrite these labels in your dataset with your own values (more information about labels).

• Score

  You can attach scores to the checkboxes to perform instant calculations. By enabling the Score feature you can enter the desired score value per choice (more information about instant scores).

Choices

For the checkboxes block you can enter the list of choices you want to show to your respondents:

• To add choices one by one click the icon at the bottom of the list;
• To import a list of choices at once, click the icon at the top of the list. You can now supply a list with one option label per text line and click Import to add them to your list of choices.

From your list of choices you can open each choice to get to the settings of that single choice. Over there you can use these features:

• Name

  This is the name of the choice.

• Description

  By enabling the Description feature, you can extend the choice name with a description, for example to show an extra explanation. This description is shown below the name.

• Exclusivity

  By enabling the Exclusivity feature you can make that choice exclusive, so if a respondent selects that choice, all other choices will be unselected, making the selected choice exclusive.

• Labels

  By default each choice will be marked as Checked or Not checked in your dataset (your results). By enabling the Labels feature you can overwrite these labels in your dataset with your own values for each choice individually (more information about labels).

• Identifier

  By enabling the Identifier feature you can set an identifier for that choice to use in the dataset (more information about identifiers).

• Score

  By enabling the Score feature you can enter the desired score value for that choice (more information about instant scores).

---

Logic

Logic is important to make your forms smart and conversational. The checkboxes block can work with the following branch conditions to help you with that:

Block conditions

• Checkbox state (checked/unchecked per option);
• All checkboxes unchecked.

Evaluate conditions

Conditions for whole block:

• Value matches your filter;
• Value does not match your filter;
• Value contains your filter;
• Value does not contain your filter;
• Value starts with your filter;
• Value ends with your filter;
• Value is empty;
• Value is not empty.

Conditions for each option:

• Option is true;
• Option is false;
• Option equals your filter;
• Option not equals your filter;
• Option is empty;
• Option is not empty.

Score conditions

• Score is equal to your filter;
• Score is not equal to your filter;
• Score is lower thanyour filter;
• Score is higher than your filter;
• Score is between your filters;
• Score is not between your filters;
• Score is calculated;
• Score is not calculated.

Filters

When we mention your filter above, there are some different filters that you can use to make the right comparison:

• Text - Compare with a fixed text that you enter;
• Value - Compare with another block value entered in the form by a respondent (more info).

---

Calculations

You can use the calculator block to perform calculations with given answers. The checkboxes block supports the following calculation operations:

• Score - Calculate a score based on the entered score list for choices;
• Count - Count the number of selected choices;
• Choice value - Output a value based on an individual selected/not-selected choice (boolean).

---