---
title: "radio buttons · RUAL Documentation"
description: "Generates a set of buttons you can choose between. The field will be used as state key."
canonical: https://docs.rual.nl/block-types/state%20elements/state_single_button_radio_option
language: en
---

[Cluster](https://docs.rual.nl/cluster)

[Blocks](https://docs.rual.nl/block-types)

[Interfaces](https://docs.rual.nl/interfaces)

[Blueprints](https://docs.rual.nl/blueprints)

[Tutorials](https://docs.rual.nl/tutorials)

[Home automation](https://docs.rual.nl/home-automation)

[Examples](https://docs.rual.nl/examples)

[Reference](https://docs.rual.nl/reference)

[Architecture](https://docs.rual.nl/architecture)

[Troubleshooting](https://docs.rual.nl/troubleshooting)

Other

# radio buttons

This block is part of the group and was last modified in core [`v13.0.6`](https://docs.rual.nl/core-versions/130006).

## Field Selection Required

This block relies on a field that you select to perform its data actions. You must manually select the field you want to use in your flow using the field selector modal. To access the modal, click the white button on the block.

Generates a set of buttons you can choose between. The field will be used as state key.

- form id required `value` A unique ID for the form this field is used in.

- options required `array` The options to be shown in the dropdown. Can either be a list of values or `[{key, value}]`.

- vertical `condition` Provide this if you want the buttons to be aligned vertical.

Default `false`

- disabled `v13.0.9` `condition` Disables all buttons if set to true.

Default `false`

- class `uiclass` Assigns a CSS class to the element. • Hidden when unused

- style `uistyle` Applies inline CSS style to the element • Hidden when unused

- attributes `uiattributes` Adds custom attributes to the element. • Hidden when unused

- state `state` Returns the element to the frontend state.

A typical wiring for [radio buttons](https://docs.rual.nl/block-types/state%2520elements/state_single_button_radio_option): [value](https://docs.rual.nl/block-types/value/value_default) feeds the `form_id` pin; [with values](https://docs.rual.nl/block-types/array/array_of_values) feeds the `options` pin; the `state` out pin feeds [get component child](https://docs.rual.nl/block-types/state%2520actions/state_component_get_child).

[![Studio canvas example for the radio buttons block: typical wiring for radio buttons.](https://docs.rual.nl/canvas-examples/state_single_button_radio_option.png)](https://docs.rual.nl/canvas-examples/state_single_button_radio_option.png?v=3)

## Version history

Introduced in [`v13.0.1`](https://docs.rual.nl/core-versions/130001).

Last modified in [`v13.0.6`](https://docs.rual.nl/core-versions/130006).

- [v13.0.9](https://docs.rual.nl/core-versions/130009): This block or one of its pins was updated in `v13.0.9`, click here to see the release notes.

- [Back to](https://docs.rual.nl/block-types/): Return to the main group to view all sub-groups

- [Back to `state elements`](https://docs.rual.nl/block-types/?group=state%20elements): Return to the group to view all blocks within this group

Was this page helpful? [Tell us what to improve](https://docs.rual.nl/support) · RUAL Docs is an integral component of the [RUAL ecosystem](https://rual.nl)