Checkbox Group

A checkbox group element is used to allow visiors the ability to select one or more options from a set of choices. It's a simple user interface component that consists of a small square boxes that can be either checked (selected) or unchecked (deselected).

Checkbox groups are ideal when the visitor can choose more than one option from a list. For example, a user might select multiple interests in a survey form.

Once the visitor selects their preferred options and submits the form, the selected checkboxes are set on the field mapped to the specific checbox group field and recorded within the form submissions tab.

Add a Checkbox Group Element to Your Form

To add a checkbox group element to your form select the orange + icon within the builder and then select "Checkbox Group".

Once the checkbox group has been added to your form please edit the settings of checkbox group via the right hand side of the screen.

Checkbox Element Settings

Within the settings of the checkbox group element there are various options to set.

These include:

• Field Label: Value that is always visible to persons filling in your form
• Field Name: The Field Name is "behind the scenes". The field name is not shown to persons filling in your form
• Map to Field: Select the Paminga field you would like to map the checkbox group to. All of your multi-select dropdown standard and custom fields will be available to map to

Checkbox Group Settings Options

Within the options of the checkbox group settings you have a few options to set.

These include:

• Use a Pre-Exisiting Drop Down: When selected you will be able to choose from any already exisiting drop downs within your account
  • Type to find a drop down or use the arrows to sort

• Create a Custom Drop Down: If you would like to create a new drop down within the form select this option. Upon selection you can update the label and add options for the checkbox group

• Allow Multiple Selection: Selecting this checkbox will allow your visitors to select more than one option from the group

Validation Rules

Within the checkbox group settings you can set validation rules for the persons submitting the form. If you choose to set the validation rule for a checkbox group it will require the visitor to mark the field.

By default a message the message is set to "This is a required field." This message can be edited.

Layout

Under the layout tab you have the ability to edit the layout of the checkbox on your form.

Here you can set the checkbox :

• Alignment (Left, Center, Right)
• Width
• Margins (Top, Bottom, Left, Right)

Easily set these parameter using the slider, or input the value to the right of each layout option.

Conditions

By default the field is set to show always. That said, you have the ability to edit the fields visibilty to conditionally display.

If you would like to edit the visibilty of the form field update the settings under the conditions tab.

You can set the field to:

• Show This Field Always
• Hide This Field Always
• Show This Field If
• Hide This Field If

Selection of the last two will prompt you to set conditions of display for this field using the Paminga segemnt builder.

The conditions available to dispaly off of are:

• Account Fields (standard & custom)
• Contact Field (standard & custom)
• Form Fields: Set the conditons based on any field's value on your form
• Language: If you leverage "Internationalization" each language you have added to the form will be available to select here

Want more information on displaying fields conditionally?

Make sure to check out our in-depth documentation here.