# List

### Overview

The **List Web Control** is a repeating element to display a collection of data. It can be used in input forms or to display data. The List Web Control iterates over a variable list, displaying a cell for each item on the list. Lists can use [Button Cell Web Controls](button-cell-web-control), [Simple Cell Web Controls](simple-cell-web-control), [Checkbox Cell Web Controls](checkbox-cell-web-control), or [Radio Cell Web Controls](radio-cell-web-control) to hold each of the items.

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

### Control Details

#### Data

The list of data. Each item in the list has its own cell.

#### Item Name

By default named as `item`. This property is used within the context of each cell as the current item.

#### Index Name

By default named `index`. This is the number value of the current index of the current item, visible within the context of the cell.

#### Collection Name

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

### Cells

Because Lists are generic containers, they can work with any of the cell types:

* [Button Cell Web Controls](button-cell-web-control)
* [Simple Cell Web Controls](simple-cell-web-control)
* [Checkbox Cell Web Controls](checkbox-cell-web-control)
* [Radio Cell Web Controls](radio-cell-web-control)

#### Example 1: Simple House List

A simple List containing the list of houses a service manages:

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

Create a list control on the page. Populate a list of Houses. Set the data to the list of houses. Add a simple cell and populate the cell with the title and image of the house.
