Skip to main content

Properties

The Radio Widget properties panel contains settings that control the radio button label, grouping, stored value, and behavior.


General

PropertyDescription
LabelThe text displayed next to the radio button.
Group NameGroups this radio with other Radio Widgets that share the same group name. Only one radio in a group can be selected at a time. The selected radio's Value is stored under the group name in the form data. If left empty, the widget's own Name is used as the storage key.
NameInternal widget identifier. Used for referencing the widget in logic or scripts.
ValueThe value stored in the form data when this radio button is selected. Each radio in a group should have a unique value.
Default SelectedSets this radio button as the selected option when the form is loaded.
Label PlacementControls the position of the label relative to the radio button: End (right), Start (left), Top, or Bottom. Default: End.
ReadonlyPrevents the user from changing the selection.
VisibleControls whether the radio button is displayed. When unchecked, the widget is hidden but remains configured.

Appearance

PropertyDescription
Text AlignControls the horizontal alignment of the radio button and label within its container.
SizeSets the visual size of the radio button element.

Advanced

PropertyDescription
On Change HandlerWhen enabled, the widget fires an onChange event to the backend each time this radio button is selected. The event payload contains widgetName (the group name), widgetValue (the selected value), and widgetEvent set to "onChange".
Ignore ReadonlyOverrides the Readonly setting. Allows the radio button to remain interactive even if the form or parent container is set to read-only.