# Repeater

he Repeater control can be used to repeat the display of specific Controls.

The number of repetitions (i.e. the number of displayed Controls) is based on the number of records in a data set. In essence the Repeater is similar to a ForEach loop, but where ForEach allows you to add Actions to the loop, Repeater allows you to add Controls to the 'loop' and to set up an [Event](/features/events.md) that triggers when a list item is loaded.

***

### Properties

1. **Inline**

   Affects the 'display' CSS property of the control. When Inline is selected the controls that are added to the Repeater will display horizantally; when Inline is not selected the controls will display vertically.
2. **Visible**

   Set to False if you don't want this control to render on the page and be visible to the user.

***

### Events

1. **Item Load**

   An event that triggers when a list item is loaded.

***

### How to use a Repeater

1. Build the template

   Add a Repeater control, then drag the required controls like Labels and Buttons into your Repeater.
2. Map the data

   Create an ItemLoad [Event](/features/events.md) on your Repeater.\
   The ItemLoad [Event](/features/events.md) passes in the single item out of your dataset it is currently loading into an iteration of your repeater. Use the properties of this item to map them to the controls in the Repeater.
3. Assign the data

   Use a Load event to start the process of assigning the dataset and iterating over it. To assign the dataset to your Repeater, use a [SetValue](/actions/set-value.md) action in your Load event. When the Repeater receives the dataset, each data item will be assigned to the mapped control, as per step 2.

![](/files/s8hDcHonKFmu0uMSX43d)


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.stadium.software/controls/repeater.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.