Radio Group (ALPHA)
Responsive Widgets are in alpha and available by invitation only on Business and Enterprise plans. Behavior and properties may change. To request access, open a support ticket and name the feature Responsive Widgets (ALPHA).
The Radio Group widget shows a list of radio buttons under one label. Users pick exactly one option. Use it for a short list where all choices should stay visible, for example a shirt size.

Widget type: WDS_RADIO_GROUP_WIDGET
Content properties
These properties appear in the Content tab of the property pane.
Data
Options array<object>
Sets the radio buttons. Each option has a label (string) and a value (string or number). Values must be unique. You can add options in the property pane or switch to JS to bind an array.
Default value:
[
{ "label": "Small", "value": "S" },
{ "label": "Medium", "value": "M" },
{ "label": "Large", "value": "L" }
]
Default selected value string
Sets the option that is selected when the widget loads. Enter the option's value. To use a number value, write it in {{ }}, for example {{1}}. Default: L.
Orientation string
Sets how the radio buttons are laid out. Options:
- Horizontal: in a row.
- Vertical: in a column.
Default: Vertical.
Label
Text string
Sets the label shown above the group. Default: Size.
Tooltip string
Shows help text or details next to the label.
Validations
Required boolean
Makes a selection mandatory. When on and no option is selected, the widget shows the message "Please select an option." Default: off.
General
Visible boolean
Controls whether the widget is visible when the app runs. Default: on.
Disabled boolean
Stops users from changing the selection. Default: off.
Animate loading boolean
Shows a loading animation while the widget's data loads. Default: on.
Style properties
These properties appear in the Style tab of the property pane.
Custom styling
These settings are in the Custom styling section, at the end of the Style tab. An empty setting uses the theme value. For theme colors, dark mode, and the rules for custom CSS, see Custom styling.
Accent color string
Builds the hover, pressed, focus, and text colors of this widget from one color, in light and dark mode. Lists and menus that the widget opens use them too. Empty means the accent of the nearest container that sets one, or the theme accent.
Custom CSS string
Adds plain CSS to this widget. Rules apply only inside the widget, and & is the box around the widget, its label included, not the part inside it. To style an inner part, use its element selector, for example button or input. You cannot bind this property.