Adding a Checkbox Input to a Form

How to add a checkbox to a form

The Checkbox input provides checkboxes for the app user to select. Checkboxes are used when more than one option can be selected, and you want all options to be presented. Click Edit to open the Edit Checkbox window. Enter a label for the group of checkboxes, then in the Options box, enter the text that will appear next to each checkbox. Put each option on a separate line.

The following outlines the best practice for using selection inputs. For more details, see Differences in Selection Inputs.

Input Type:	Example:
Checkbox Use when less than 7 options. All options display in app. Multi-selection. All options appear with selection marked on reports.
Lookup Use when more than 15 options. Search available in the app. Single or multi-selection. Only selected options are shown on reports.
Radio Use when less than 7 options. All options visible in app. Select one option only. Marking one option unselects another option. Only selected option is shown on reports.
Segmented Button Use when 2-5 options. Single or multi-selection. All options appear on reports, with color if applicable.
Select Use when 7-15+ options. Not all options visible. Uses very little space in the app. Single or multi-selection. Options containing long text may be cut off. Only selected options are shown on reports.

1. From the Input menu in the Form Designer, click Checkbox.
   
2. Click  (Edit) to open the Edit Checkbox window.
   
3. On the Settings tab, mark Required to make the checkbox a required field. 
   Mark Used for Personal Data if the checkbox field is used for personal data which can be used to delete specific data from a form. By checking this option, when using the Data Deletion page, non-personal data is kept for analysis, while deleting the personal data. After marking this option, an icon appears next to the text alignment icon in the Admin site indicating this field is used for personal data: 
   
4. Mark Read-Only to make the checkbox read-only.
5. Enter a label for the checkbox.  
6. In the Tooltip field, enter the tip/hint you may want to include for the checkbox.

7. Mark Show Select All Checkbox to determine whether a Select All option appears for a set of checkbox inputs. This allows you to control how the mobile app users can quickly check all boxes, or individually determine whether each is marked.

   Mark Add Field to Last Option to add a field next to the last checkbox which allows the mobile user to enter additional text or a number about the last option. For example, if your last checkbox is “Other, please specify.” you can use this option to add the text right next to the last checkbox.  
8. Toggle the Displayed Value is Different than Saved Value on if you want the checkbox options to display differently than what's saved.
9. Mark options as a default for the checkbox input, if a common set of checkboxes is typical for this form. 
   Toggle on Use Default Value, then select the options from the list you want to default when using the app. Defaults can be changed during form entry.
   

   Mark Enter Default Value to enter a default value.

   Mark Default Value from Another Field to default a value from another field. Then from the Select Form Field list, select the field you want to use to default from.

10. Click the Styles tab to specify the style settings for the checkbox. See Using the Styles Tab for more information. If you justify a checkbox to the right, the box will appear to the right of the text. Checkboxes cannot be center justified.
11. Click the Validations tab to create a validation for the checkbox. See Creating Field Level Validations for more information.
12. Click the Field Condition tab to create a condition for the checkbox.
13. Click OK to save your entries. Click Cancel to close the Edit Checkbox window without saving changes.
14. Click (Preview) to view how the Checkbox input will look in the app. Because the Add Field to Last Option was marked in the Edit Checkbox window, there is a field after the "Other" option.