How to Add a Radio Button field to a workflow

Radio buttons are a useful form component to add to your workflows allowing people to select a single selection option. Adding a radio button field to your workflow is easy with the ability to add your own selection options, make the field mandatory, restrict view and editor access, display data from other radio button fields and conditional display of the field.

‍

Simply select the "Radio button" from the component tool bar to add a radio button to your workflow canvas.

‍

Radio buttons can be used for any use case where a single selection is required. Some examples include:

• Product option selection
• Location selection
• Number range selection

The radio button field is very flexible and can be used for any use case based on the purpose of your workflow.

1. Open an existing workflow or create a new workflow.
2. Click on the "Radio button" option on the component toolbar to add the field to your workflow canvas.
3. Configure the settings of the field in the "Radio button settings" pane on the right hand side of the flow builder.
4. Drag the "Radio button" field to the desired location on the stage canvas.
5. Use the grab handles to change the width and height of the "Radio button field.

The following general settings are available to configure the "Radio button" field:

• Label: Add a text label to display text above the radio button field. Delete this text if you do not want a label to be displayed.
• Options: By default, there are three (3) options available for the radio button selection options. Change the text for each option to represent the options that you would like to be displayed for selection. Add more selection options by clicking on the "Add" button and delete existing options by clicking on the trash icon next to each option.
• Viewers: By default, anyone will be able to view the radio button field. If you would like to restrict who can view the field when completing assessments, select the role or individual people from the "Viewers" drop-down field.
• Editors: By default, anyone will be able to select the radio button field options. If you would like to restrict who can select the radio button options when completing assessments, select the role or individual people from the "Editors" drop-down field.
• Display Data From: If you have another radio button field, you can automatically populate the value from that field to display in another radio button field. This is particularly useful where you have a workflow stage which is a confirmation page based on previously input values to summarise what was input. Click on the "Display data from" dropdown to select another radio button field. The field will be read only when displaying data from another field.
• Inactive: When clicking the "Inactive" checkbox, the radio button field will be displayed in an inactive state and the field will not accept any input.
• Required: Select the "Required" checkbox if input is required in the radio button field when completing assessments. Validation will occur when someone clicks on a button where the button's "Check required" setting is selected.
• Required Text: If the "Required" checkbox is selected a message will appear below the radio button field advising that the field requires a selection on button click. Change the "Required text" to display your own custom validation message.
• Add to assess table: Select this option if you would like the field value to be displayed as a column when viewing all assessments under the "Assess" page.

Conditional Display

Conditional display provides you with the ability to display the radio button field when certain conditions are met with other fields in the workflow. For example, if I add a dropdown field to the workflow canvas with the options Yes, No and Other. When someone selects "Other" then the radio button field will be displayed.

• IF: Select the "Field" option from the drop-down (currently the only value available)
• Field: Select a radio, dropdown or checkbox field that has been added to any stage canvas of your workflow.
• Equals: Select the field value that will result in the radio button field being displayed.