Adding a Radio Input to a Form

How to add a Radio input to a form

The Radio input provides radio buttons for the tech to select. Radio buttons are used when you have multiple choices, but only one can be selected. The benefit of using radio buttons over a selection list is that all options are always visible. A good rule of thumb is if there are 7 or fewer options, use radio buttons.

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 Radio.
   
2. Click  (Edit) to open the Edit Radio window.
   
3. If you want to use a data set for this radio, toggle on Use Data Set, then select the data set and data set field to use. In the Connect Data Set and Form Data section, click + to set the connection between the form and the data set and filter the data set to be more specific to the form.
4. If you selected a real time data set, any parameters associated with the data set are displayed. Select the value from the form to filter the data. 
5. On the Settings tab, mark Required to make the radio buttons required. Mark Hidden if you don't want the radio buttons to appear in the app. 
   Mark Used for Personal Data if the radio 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: 
   
   Mark Read-Only to make the radio button read-only.
6. Enter a label for the radio button. When the Use Data Set toggle is on, this field defaults to the data set field's label, but you can change it. It is helpful to have a unique label when a data set is used on two different fields.
7. In the Tooltip field, enter the tip/hint you may want to include for the radio buttons.
8. Mark Enable for Calculated Fields to use the radio button in calculated fields. When this option is marked, numbers must be used as the options.
9. Mark Add Field to Last Option to add a field next to the last radio button which allows the mobile user to enter additional text or a number about the last option. For example, if your last radio option is “Other, please specify.” you can use this option to add the text right next to the last radio button. 
10. Toggle the Displayed Value is Different than Saved Value option on if you want the radio button options to display differently than what's saved.
11. Enter each radio button option on a separate line in the Options box. Options can be pasted in from a spreadsheet or other type of document. 

12. Select if you want the radio buttons to appear horizontally or vertically.

13. Mark options as a default for the radio buttons input. 
    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.

14. Click the Styles tab to specify the style settings for the radio buttons. See Using the Styles Tab for more information. 
15. Click the Validations tab to create a validation for the radio buttons. See Creating Field Level Validations for more information.
16. Click the Field Condition tab to create a condition for the radio buttons.
17. Click OK to save your entries. Click Cancel to close the Edit Radio window without saving changes.
18. Click (Preview) to view how the Radio input will look in the app.