Checkboxes

Summary

The Checkboxes field allows you to present one or many checkboxes which allow multiple selections. It is available under the Standard Fields section within the form editor.

GForms Checkbox Selector

Checkboxes field as displayed in the Field Library

GForms Checkbox Field

Checkboxes field as displayed in the Form Editor.

Click the Edit Choices button under Choices to open the Edit Choices flyout.

Important: If your choice labels contain any HTML or special characters such as ampersands, commas, hyphens or brackets of any type, you MUST enable the show values feature and give each choice a simple and unique value which does not contain any special characters. Failure to configure values could cause issues for features such as calculations, conditional logic, dynamic population, and validation.

Important: Once the form has entries the choices should not be changed. Adding, removing, re-ordering, or renaming checkbox choices will result in the input ids associated with the choices changing which could break the connection to the choices already stored in the existing entries and prevent them being exported.

Common Settings

This field uses only common field settings for the Appearance and Advanced settings. For a description of each of the common field settings, refer to this article. Below you will find a description of specialty settings that are particular to this field.

General Settings

Click the Edit Choices button under Choices to open the Edit Choices flyout.

Image showing the Multiple Choice field flyout options.
SettingDescription
ChoicesAdd Choices to this field. You can mark each choice as checked by default by using the checkbox that appears to the left of each choice. Add a new choice by clicking the PLUS (+) icon and delete a choice by clicking the DELETE (-) icon.
Clear default choicesAllows you to clear the choice set as default. Only available when a choice has been selected as the default choice.
Show ValuesChecking this option will allow you to specify a value for each choice. Choice values are not displayed to the user viewing the form but are accessible to administrators when viewing the entry.
Bulk Add / Predefined ChoicesAllows you to select a category and customize the predefined choices or paste your own list to bulk add choices. See note 1.

Notes

1. See this article for more information.

Enable Select All

Checking this adds a Select All button to the bottom of the checkboxes list, allowing the user to select all available list items.

Image showing Select All choice enabled.
Image showing a checkbox field with the Select All option enabled

Merge Tags

For more information on the use of merge tags, refer to these articles.

Usage

{Field Name:2.1:modifier}

Notes:

  • The field name is optional.
  • The second parameter is the field ID. If a single number, it can be used to get the value of the field ID. If multiple numbers separated by a period, it will get a specific selection within that field. For example, 2 will return the result of field ID 2, while 2.1 will return the first checkbox within field ID 2.
  • The third, and any subsequent parameters are used for modifiers. These are separated by a colon, and may contain multiple modifiers if applicable.

Modifiers

ModifierDescription
:valueDisplays the actual value of the checkbox rather than the value label.
:currencyDisplays the value as currency.
:priceSame as :currency.

Calculations

If you’re going to use this field type in a calculation formula, please check Number Formatting Rules in the Calculations doc page.