{"id":6334,"date":"2014-05-08T15:17:09","date_gmt":"2014-05-08T19:17:09","guid":{"rendered":"http:\/\/localhost\/documentation\/"},"modified":"2026-03-03T09:08:55","modified_gmt":"2026-03-03T14:08:55","slug":"checkboxes","status":"publish","type":"post","link":"https:\/\/docs.gravityforms.com\/checkboxes\/","title":{"rendered":"Checkboxes"},"content":{"rendered":"\n

Summary<\/h2>\n\n\n\n

The Checkboxes<\/strong> 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.<\/p>\n\n\n\n

\"GForms<\/figure>
\n

Checkboxes field as displayed in the Field Library<\/a><\/p>\n<\/div><\/div>\n\n\n\n

\"GForms<\/figure>
\n

Checkboxes field as displayed in the Form Editor<\/a>.<\/p>\n<\/div><\/div>\n\n\n\n

\"\"<\/figure>
\n

Click the Edit Choices button<\/strong> under Choices<\/strong> to open the Edit Choices flyout<\/a>.<\/p>\n<\/div><\/div>\n\n\n\n

Note:<\/strong>\u00a0When using a choice-based field type and your choice labels contain any HTML or special characters such as ampersands, commas, pipes, hyphens, <\/span>or brackets of any type, you\u00a0MUST\u00a0enable the show values feature and give each choice a simple and unique value\u00a0which does not contain any special characters<\/strong>. Failure to configure values could cause issues for features such as calculations, conditional logic, dynamic population, and validation. The value for each choice must be unique in any case<\/strong>, even if you\u2019re not using HTML or special characters for the choice labels.<\/p>\n\n\n\n

Common Settings<\/h2>\n\n\n\n

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<\/a>. Below you will find a description of specialty settings that are particular to this field.<\/p>\n\n\n\n

General Settings<\/h2>\n\n\n\n
\"\"<\/figure>
\n

Click the Edit Choices button<\/strong> under Choices<\/strong> to open the Edit Choices flyout<\/a>.<\/p>\n<\/div><\/div>\n\n\n\n

\n
\"Image<\/figure>\n<\/div>\n\n\n\n
Setting<\/th>Description<\/th><\/tr><\/thead>
Choices<\/strong><\/td>Add 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. See note 1.<\/strong><\/td><\/tr>
Clear default choices<\/strong><\/td>Allows you to clear the choice set as default. Only available when a choice has been selected as the default choice.<\/em><\/td><\/tr>
Show Values<\/strong><\/td>Checking 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.<\/td><\/tr>
Bulk Add \/ Predefined Choices<\/strong><\/td>Allows you to select a category and customize the predefined choices or paste your own list to bulk add choices. See this article<\/a> for more information.<\/strong><\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n

Enable Select All<\/h3>\n\n\n\n

Checking this adds a Select All button to the bottom of the checkboxes list, allowing the user to select all available list items.<\/p>\n\n\n\n

Modifying Checkbox Choices After Form Submissions<\/h3>\n\n\n\n

After a form has collected entries, you should avoid changing checkbox choices. Modifying the choices, such as adding<\/strong>, removing<\/strong>, reordering<\/strong>, or renaming<\/strong> them, will change the input IDs associated with each option. This may break the link between stored entry data and the original choices, potentially preventing the data from being exported correctly.<\/p>\n\n\n\n

\n
\"Image<\/a><\/figure>\n\n\n\n
\"Image<\/a><\/figure>\n<\/div>\n\n\n\n

Merge Tags<\/h2>\n\n\n\n

For more information on the use of merge tags, refer to these articles<\/a>.<\/a><\/p>\n\n\n\n

Usage<\/h3>\n\n\n\n
{Field Name:2.1:modifier}<\/pre>\n\n\n\n
Notes:<\/strong><\/p>\n\n\n\n