---
url: https://docs.juniper.bot/en/message-templates/components/radio-group.md
description: Radio Group component used in Modal Forms.
---

[action]: ../../../cmd/custom/actions/index

[actions]: ../../../cmd/custom/actions/index

[`modal.values`]: ../../types/custom-commands/modal

# Radio Group

Radio Group is data input component that lets your members pick a single option of radio buttons group.

This component has the following settings:

![radio_group_settings_en](radio_group_settings_en.png)

* **Label** — label displayed on the radio group;
* **Description** — description displayed on the radio group with smaller font size;
* **Identifier** — component identifier, enter something related to the component;
  ::: info
  Identifier must be unique across all message components of this action.

  The message template of [Action] being executed by this modal will get [`modal.values`] variable map, which keys
  will be those identifiers and their values are data entered by member.

  Thus, this way [Action] can determine what exact option has been selected.
  :::
* **Required** — the value will be required to fill if checked;
* **Radio Buttons** — the list of radio buttons in the group (from 2 up to 10).

## Radio Buttons { #options }

Radio buttons have the following settings:

![radio_settings_en](radio_settings_en.png)

* **Label** — Label of the radio button;
* **Value** — Value of the radio button, enter something related to this option;
  ::: info
  It must be unique across all radio buttons of this group.

  This value will be passed to [`modal.values`] value related to this component.

  Thus, this way [Action] can determine what exact option has been selected.
  :::
* **Description** — radio button description;
* **Checked by default** — checking this will make this radio button to be selected by default;

## Availability { #availability }

This component is only available for [Modal Form](../../../cmd/custom/actions/modal-form) actions.