bookmark_borderCheckboxes

The Checkboxes field allows you to present one or many checkboxes which allow multiple selections.

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 conditional logic.

General

Checkboxes General

  • Field Label
    Enter the label of the form field. This is the field title the user will see when filling out the form.

  • Description
    Enter the description for the form field. This will be displayed to the user and provide some direction on how the field should be filled out or selected.

  • Choices
    Add Choices to this field. You can mark each choice as checked by default by using the radio buttons that appear to the left of each choice. Add a new choice by clicking the PLUS icon and delete a choice by clicking the DELETE icon.

    • show values
      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.
  • Bulk Add / Predefined Choices
    Clicking the Bulk Add / Predefined Choices allows you to select a category and customize the predefined choices or paste your own list to bulk add choices.

  • Rules
    These properties set rules for how the data should be handled.

    • Required
      A required field will prevent the form from being submitted if it is not filled out or selected.

Appearance

Checkboxes Appearance

  • Description Placement
    This option can be used to place the field description either above or below the field.

  • Custom Validation Message
    If you would like to override the default error validation for a field, enter it here. This message will be displayed if there is an error with this field when the user submits the form.

  • Custom CSS Class
    Enter the CSS class name you would like to use in order to override the default styles for this field.

Advanced

Checkboxes Advanced

  • Admin Field Label
    Enter the admin label of the form field. Entering a value in this field will override the Field Label when displayed in the Gravity Forms administration tool.

  • Visibility
    Select the visibility for this field. Field visibility set to Everyone will be visible by the user submitting the form. Form field visibility set to Admin Only will only be visible within the Gravity Forms administration tool. Setting a field to Admin Only is useful for creating fields that can be used to set a status or priority level on submitted entries.

  • Allow field to be populated dynamically
    Check this option to enable data to be passed to the form and pre-populate this field dynamically. Data can be passed via Query Strings, Shortcode and/or Hooks.

  • Enable Conditional Logic
    Create rules to dynamically display or hide this field based on values from another field. Remember, to use conditional logic, you will need to create a drop down, checkbox or multiple choice field.

Merge Tags

Usage

{Field Name:2.1:modifier1}

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

  • :value
    Displays the actual value of the checkbox rather than the value label.
  • :currency
    Displays the value as currency.
  • :price
    Same as :currency.