# Create a leaderboard display

A leaderboard display is a ranked standings screen for one competition. It cycles through the apparatus you choose on a timer and shows who's in first, second, third, and so on.

You build one leaderboard per scope. If you want standings for Level 4 and Level 5 both visible, you create two leaderboard modules and add them both to a loop.

## Prerequisites

* [Configure levels and categories](/meet-setup/configure-levels-and-categories.md) so you have something to rank
* [Scores entered](/scoring/enter-scores-admin.md) for at least some gymnasts (or you'll see an empty board)

## Steps

1. From the meet dashboard, click **Projector Display** in the sidebar.
2. In the **Module library** panel on the left, click **Create**.
3. Pick **Leaderboard** as the module type and click **Create**.

A new module opens in the middle panel with the configuration form.

## Configuration fields

Work down the form top to bottom. Click **Save** when you're done (or use **Add to loop** to drop it straight into the loop builder).

### Module name

Give it a name you'll recognize in the library, like "Level 4 WAG - Saturday AM". The name doesn't appear on the projected screen.

### Scope

Defines what gymnasts appear on the leaderboard.

* [**Level**](/levels/index.md) — Which competition level to rank
* **Category** — [Individual](/levels/individual-score-settings.md) or [team](/levels/team-score-settings.md) scoring
* [**Competition**](/competitions/index.md) — [Age group](/competitions/create-age-groups.md) or [subdivision](/competitions/create-subdivisions.md) grouping (depends on your meet's structure)
* **Subdivision** — If the competition is split into [subdivisions](/competitions/create-subdivisions.md), pick which one
* **Vault score rule** — Override the level's default [vault decision](/levels/vault-score-decision.md) (one vault, average, or best). Only shows when vault is in your apparatus order.
* **Show two vault rows** — Display both vault attempts separately instead of the combined score. Only shows when vault is in your apparatus order.

### Apparatus order

The list of apparatus the leaderboard cycles through.

For example, if your selected apparatus is Vault → Bars → Beam → Floor, the screen shows the vault standings first, then bars, then beam, then floor on seperate screens each lasting the seconds per page as described below.

### Seconds per page

How long each apparatus stays on screen before rotating to the next one. Defaults to 8 seconds. Reasonable values are 6 to 15 seconds — long enough for someone to read, short enough to keep the loop moving.

### Visibility

What columns appear on the projected table.

* **Show rank** — The numeric placement column
* **Show start value** — The D score column
* **Highlight top three** — Visual emphasis on positions 1, 2, and 3

### Club display

How club names render on the board.

* **Show club** — Toggle the club column on or off
* **Club max characters** — Truncate long club names to this character count (default 6)
* **Abbreviate club name** — Use the club's abbreviation instead of the full name

### Max gymnasts per group

Caps how many gymnasts appear per apparatus page. Useful when you have 80 gymnasts in one competition and only want to show the top 20 per apparatus. Leave blank to show everyone.

### Colors

Pick the background, highlight, and text colors using hex codes. This is how you match your club or event branding. All three take 6-digit hex (for example, `2E7D32` for green).

## Preview it

Click **Show display** at the top of the form. That opens the full-screen projector view with only this module playing, so you can check the look before adding it to a loop.

## What's next

* [**Create a latest scores display**](/projector/create-a-latest-scores-display.md) — Live score feed to pair with the leaderboard
* [**Build a display loop**](/projector/build-a-display-loop.md) — Combine this leaderboard with others into a rotating playlist

## Related

* [View rankings](/results/view-rankings.md) — The admin-facing leaderboard (different page)
* [Handle vault scoring](/scoring/handle-vault-scoring.md) — Context for the vault score rule
* [Projector display overview](/projector/index.md)


---

# 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.gymart.org/projector/create-a-leaderboard-display.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.