Skip to content
Version 2026.25

Multistate Button ​

Hand / Off / Auto and other pick-one states, with a ring while the PLC catches up.

In Studio ​

In Studio, double-click Multistate Button 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 Multistate Button for a mode select whose command the PLC confirms on a separate status tag. Pick selector for a look that matches a panel selector switch.

Properties ​

PropertyTypeDefaultDescription
ValueString(none)The bound command tag each state's value is written to.
StatusString(none)The bound status tag the PLC echoes the state on. The selected state follows it, and the pending ring waits for it. Blank means the command tag is its own echo.
LabelStringModeThe accessible name of the control.
Variantsegmented, buttons, selectorsegmentedHow it looks: segmented (default), buttons (separate pills) or selector (a rotary selector switch).
States (comma-sep)StringHand,Off,AutoThe name of each state, comma-separated.
Write Values (comma-sep)String0,1,2The value written for each state, comma-separated and in the same order.
Pending Timeout (ms)Number3000How long the ring waits for the echo before it drops and the control shows the state the PLC actually reports.
Requires Signaturefalse, truefalseSame contract as Button's Requires Signature — defers the write to the electronic-signature dialog.
Track ColorColor#C4C4C4The recessed track the Segmented variant sits in. It is a property with one built-in default: set it to a color, or to a var(--name) that a style class defines.
Selected Segment ColorColor#37536DThe fill of the selected segment (Segmented variant).
Selected Text ColorColor#FFFFFFThe text on the selected segment (Segmented variant).
Text ColorColor#333333The text of the unselected segments and buttons (Segmented and Buttons variants).
Button Face ColorColor#E0E0E0The face of the unselected buttons (Buttons variant).
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 the chosen state's value. A pulsing ring marks the choice until the status tag matches; the selection itself only moves when the PLC reports it.