A Radio Button is a graphical user interface that allows the user to choose one of a predefined set of options. Radio buttons are arranged in groups of two or more and displayed on screen as a list of circular holes that can contain white space (for unselected) or a dot (for selected). Adjacent to each radio button is a caption describing the choice that the radio button represents. When the user selects a radio button, any previously selected radio button in the same group becomes deselected. Selecting a radio button is done by clicking the mouse on the button.

Adding a Radio Button to the Form

1. In the Edit Form canvas, drag the from Form Widgets palette onto the form canvas. A new radio button field is added in the canvas.
   
2. Enter a Label for your Radio Button widget. Notice that the Data Field associated with the widget is now populated with the label name but without the spaces.
   
   The Data Field name should not contain any spaces and should be a unique name within the collection.
3. The Properties section of the form editor will allow you to customize the data properties of the widget. Be sure the Data tab is selected.
   
4. Under Data Type select the type of data that will be used in your Radio Button. You can choose from string (text), integer, decimal, boolean (true/false), date, time, date-time, or duration.
5. The Required Field radio button allows you to determine if the field needs to be filled out before a user is able to save the record. If the field is marked as a required field, it will be designated with a red asterisk (*) in the form.
6. The Display this field in the default Collection View checkbox allows you to add this field as a column in the collection tab's view without having to enter the View Editor.
7. Select either the Simple or Calculated radio button. Simple will allow users to choose a value from the available options while calculated will populate the radio button widget based on an expression defined using the Expression Builder. If you select the Calculated option the Properties section will change, allowing you to enter an expression in the Value box.
   
8. For Simple radio button widgets, you can define the values which will appear in the drop down list by clicking on the button to the right of Values.
   
   The Possible and Default Value window will open, allowing you to define the options which will appear in the radio button widget.
   
9. Click on the Add button to add more options to the radio button. Options can also be deleted by clicking on the Remove button.
10. Click on the Key column for Option1 and enter a name for the option. When you click out of the Key column, the Value column will automatically update to match the Key column. If you wish, you can define a different name for the Value column by clicking on the column and entering a name. The Key column is what is displayed in the widget itself while the Value column is what is actually stored in the database when the option is selected.
    
11. A combo box's option can be re-ordered by clicking on the Up or Down buttons.
12. Clicking on the Default Value radio button will display a textbox where you can define a default value for the widget.
13. Click Done when you are finished defining the options for the widget.
14. Authors can define Conditional Styling options for the widget by clicking on the Widget tab in the Properties section. Select the Conditional Style row and click on the button.
    
15. Once you have finished defining the Radio Button, click Save to save the changes to your form. Refer to the section on Version Management for more information.
16. Click Exit to close the Form Editor and return to the Collection page.