# Radio Button List

### Overview

A Radio Button List is a repeating component that allows the user to select only one item from a list. This differs from a [Checkbox List](checkbox-list-web-control) in that hat allows for multiple items to be selected. This differs from a [Dropdown List](dropdown-list-web-control) in that the items are all visible at all times.

![organizing info](https://1191388742-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FhOn9CLWoV9VfJeM5EDAa%2Fuploads%2Fgit-blob-d0c0d5db398232918e3b87d0635a1174cf794572%2Fradio-button-list-web-control-v1715-0.gif?alt=media)

### Control Details

#### Value

The selected option. Since only one can be selected, this should be the same type of **item.**

#### Data

This is the list of data. Each item in the list will have its own item on the radio list.

#### Value Text

If provided, this is the value stored in the selected item, provided in the Selected argument. The entire **item** will be stored in the list when selected if not provided.&#x20;

**Note**: Because of the way radio lists are constructed, it is possible to modify the text in **Value Text** and have the checkbox still be selected even if does not match the **item** value.

#### Selected

This is an OPTIONAL expression that can be used to determine if an **item** should be selected.

**Note:** that only one item may be selected in a radio list at a time. If you modify the value text and set a Selected condition, then your radio cell might not be selected when clicked.

#### Item Name

By default : `item`. This property is used within the context of the checkbox cell as the current item in the cell.

#### Index Name

By default: `index`. This is the number value of the current index of the current item. Visible within the context of the Checkbox Cell.

#### Collection Name

By default: `items`. This is a variable referring to the entire collection of objects. With the default values set up, `item[index] = item`.&#x20;

### Radio Cell

[Radio Cell](radio-cell-web-control) is the default container within the Radio List and comes with all Radio Lists. Within the radio cell, the selected item can populate the information to the user. If a radio control is placed within the radio cell, it will be selected when the item is selected.

### Examples

#### Example 1: Simple Radio List with a Label

![organizing info](https://1191388742-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FhOn9CLWoV9VfJeM5EDAa%2Fuploads%2Fgit-blob-43cd34fd9bc9f16236f8fb8bee792f56d260ec8d%2Fradio-button-list-web-control-v1715-1.png?alt=media)

This radio list can easily be created by inserting a Radio List. Set the value of the selected object (in this case, type). In the **Data Binding** section, set the **Data** to the collection.&#x20;

This default example will take care of the selection. No additional properties are required on the Radio Cell, nor are any actions needed to maintain the selection. The radio list will maintain it.
