Skip to content
Version 2026.25

Checkbox / Radio Group ​

A checkbox group or a radio group, in classic, card or segmented style.

In Studio ​

In Studio, double-click Checkbox / Radio Group in the Components category of the Components panel. It is added to the open view, where you can drag it into place.

When to use ​

Use Choice Group for options and permissives: a radio group when exactly one option applies, a checkbox group when any number do. Pick segmented for two to five short options.

Properties ​

PropertyTypeDefaultDescription
ValueString(none)The bound tag the choice is read from and written to.
LabelStringOptionsThe accessible name of the group.
Moderadio, checkboxradioradio (default) holds one option's value in the tag. checkbox holds a bit mask: option 1 is bit 0, option 2 is bit 1, and so on, so a single option is an ordinary 0/1 tag.
Variantclassic, cards, segmentedclassicHow it looks: classic (default, marks beside text), cards (large touch targets) or segmented (one pill strip). A selected choice is drawn in the HMI selected slate.
Options (comma-sep)StringOption 1,Option 2,Option 3The display text of each option, comma-separated.
Values (comma-sep)String(none)Radio mode: the value written for each option, comma-separated and in the same order. Blank means the option text. Ignored in checkbox mode.
Directioncolumn, rowcolumnStacks the classic and card options in a column (default) or lays them out in a row.
Requires Signaturefalse, truefalseSame contract as Button's Requires Signature — defers the write to the electronic-signature dialog.
Quality Markstandard, dimstandardHow a lost link is marked when a value this component shows has Stale or Bad quality. standard (the default) draws the quality outline and glyph over the value. dim keeps the last good value on screen, faded, with nothing drawn over it: it suits a dense panel where one lost link turns a whole column Bad. The value still reads as not live, and a binding that fails to evaluate keeps its outline either way.

Binding ​

Click Bind… on the Value property and bind it to a tag or an expression to drive the live value.

To let an operator change the tag from this component, tick Bidirectional (read-write) on the binding. Without it the component only displays the value.

Writes on click. Checkbox mode reads the current mask and writes it back with one bit flipped, so two operators changing different boxes in the same instant can overwrite each other.