> For the complete documentation index, see [llms.txt](https://docs.gymart.org/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.gymart.org/projector/build-a-display-loop.md).

# Build a display loop

A display loop is a playlist. You pick which modules should appear on the projector and in what order, and the projector cycles through them on a timer. Each module controls its own duration, so the loop's total runtime is the sum of its parts.

You can build as many loops as you want. A typical setup is one loop per TV location: a "main hall" loop that rotates every level's leaderboard plus the latest scores feed, and a "vault station" loop that only shows vault-specific content.

## Prerequisites

* At least one [leaderboard display](/projector/create-a-leaderboard-display.md) or [latest scores display](/projector/create-a-latest-scores-display.md) saved

## Steps

![Open Projector display in the sidebar, create modules in the library, then build a loop and Start display.](/files/UKT7qLFkVkwHqrejmcKs)

1. From the meet dashboard, click **Projector display** in the sidebar.
2. In the **Display loop** panel on the right, click **New loop**.
3. Give the loop a name (for example, "Main Hall", "Vault Station", "Saturday AM") and click **Create**.

The new loop is now selected in the loop dropdown. It starts empty.

### Add modules to the loop

1. In the **Module library** panel on the left, click the module you want to add. Its configuration opens in the middle panel.
2. Click **Add to loop**. The module appears in the loop builder's list on the right.
3. Repeat for each module you want in this loop.

### Reorder modules

Drag modules up and down in the loop builder list. The order here is the order the projector plays them. A full cycle plays every module once, then starts over from the top.

### Remove a module

Click the remove button next to a module in the loop list. The module itself isn't deleted — it stays in the library and in any other loops that reference it.

### Save

Click **Save** in the loop builder panel. Until you save, the dropdown shows "Unsaved" next to the loop name, and edits aren't picked up by any running projector.

## How timing adds up

The loop builder shows the total runtime and screen count at the bottom of the panel. The calculation is:

* **Leaderboard display** — Each apparatus counts as one page. A leaderboard with 4 apparatus at 8 seconds per page contributes 32 seconds.
* **Latest scores display** — Counts as one page at the module's seconds-per-page setting. A latest scores module at 30 seconds contributes 30 seconds.

Sum those across every module in the loop to get the total cycle time. A loop under 2 minutes is usually a good target so spectators don't wait long to see their apparatus come back around.

## Manage existing loops

* **Rename a loop** — Click **Edit loop** to change the name
* **Duplicate a loop** — Inside the edit dialog, use the duplicate option to copy a loop and modify it
* **Delete a loop** — Click **Delete loop**. This removes the loop only; the modules inside it stay in the library

## What's next

* [**Launch the projector**](/projector/launch-the-projector.md) — Open the loop in full-screen on a venue computer
* [**Update a running projector from another device**](/projector/update-from-another-device.md) — Change what's showing live

## Related

* [Create a leaderboard display](/projector/create-a-leaderboard-display.md)
* [Create a latest scores display](/projector/create-a-latest-scores-display.md)
* [Projector display overview](/projector/index.md)