Add Radio Boxes

Audience: Low-code Engineers

Skill Prerequisites: Forms, Tokens

Adds a group of radio buttons, where users pick one option, to a Dynamic Field Container when the form loads. The options can also be shown as buttons. It works like a Radio Boxes field placed in the form builder.

See Dynamic Fields for how dynamic fields work and how to set up the container.

Typical Use Cases

• Ask a question with a few answers for each item in a list, for example Yes, No or Not sure
• Show a choice as a row of buttons, for example Approve or Reject

Don't use it to

• Offer many options. Use Add Dropdown instead.
• Allow several selections. Use Add Checkbox List instead.

Related Actions

Action Name	Description
Add Dropdown	Shows the options in a dropdown.
Add Checkbox List	Allows several selections.

Input Parameter Reference

This action has the common parameters, except Secure Input and Readonly, and the list parameters, including Link To. It also has:

Parameter	Description	Supports Tokens	Default	Required
Display Horizontally	Enter true to show the options side by side instead of one per line.	Yes	empty string	No
Radio Buttons	Enter true to show the options as buttons instead of radio circles. The four settings below only apply when it's true.	Yes	empty string	No
Radio Buttons CSS Classes	CSS classes for the buttons.	No	btn btn-outline-primary	No
Radio Buttons styles	Inline styles for the buttons.	No	empty string	No
Word between buttons	Text shown between the buttons.	No	or	No
Word styles	Inline styles for the text between the buttons. Use px for font sizes.	No	empty string	No

Set Initial Value to the value of the option to select when the form loads.

Output Parameters Reference

Parameter	Description
Field ID Token Name	Optional. Token that receives the cleaned field ID. If empty, the ID is saved in [<FieldId>:Name].

When the form is submitted, the selected value is available in [<FieldId>].

Examples

tip

To understand how to use the below examples, please see Running Examples.

1. Add a Yes/No question for each list entry

Put this action inside an Execute Actions for each List Entry that loops over a Questions list with Id and Text columns, in the form's On PreInit or On Init actions. It adds a required horizontal Yes/No question for each entry.

{
    "Title": "Add Radio Boxes",
    "ActionType": "AddMultipleChoiceWithRadioButtons",
    "Description": "Add a question",
    "Condition": null,
    "Parameters": {
        "ContainerId": "Survey",
        "FieldId": "Q[Questions:Id]",
        "FieldName": "[Questions:Text]",
        "InitialValue": "",
        "Horizontal": "true",
        "RadioType": "false",
        "DataSource": {
            "Expression": "",
            "Value": "Items",
            "IsExpression": false,
            "Items": "Yes|yes\nNo|no"
        },
        "TokenizeParameters": true,
        "LinkToFields": "",
        "IsRequired": "true",
        "FieldIdTokenName": ""
    }
}

Revised 09/25/2026