# Checkbox List

### Overview

A Checkbox List is a repeating component that allows the user to select one or a combination of items from a list. This differs from a [Radio List](radio-button-list-web-control) and a [Dropdown](dropdown-list-web-control) in that it is possible to select more than one item from a Checkbox List.&#x20;

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

### Control Details

#### Value

This is the list of selected options from the checkbox list.

#### Data

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

#### Value Text

If provided, this is the value stored in the selected objects array, provided in the Selected argument. The entire `item` will be stored in the list when selected if not provided.

#### Selected

This expression is executed on each item in the list to determine whether it is currently selected.&#x20;

#### 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, `items[index] = item`&#x20;

### Checkbox Cell

[Checkbox Cell](checkbox-cell-web-control) is the default container with a checkbox cell and is part of the Checkbox List. Within the Checkbox Cell, the selected item can populate the information to the user. If a [Checkbox Control](checkbox-web-control) is placed within the Checkbox Cell, it will be selected when it passes the selected criteria on the Checkbox List Web Component.

### Examples

#### Example 1: Simple Checkbox

A simple Checkbox with a Label:

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

This list can be created by inserting a Checkbox List and setting the Value of the list to a [List](../variable-data-types/the-list-data-type) of selected objects (in this case, houses). In the Data Binding section, set the Data to the collection. Set Selected to `CONTAINS(selected_houses,  item)` where selected houses are the list of items to be selected, and the item is the current item in the list.

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