> ## Knowledge Base Index
> Fetch the complete knowledge base index at: https://helpdesk.ggcircuit.com/sitemap.xml
> Use this file to discover available pages before exploring further.
> Pure-Markdown content can be obtained by appending a '.md' suffix to the content URLs listed in the sitemap (without the trailing slash).

# Running a tournament in ggLeap

![](https://storage.crisp.chat/users/helpdesk/website/-/a/f/d/6/afd6941e8bc7d800/image_3oglvm.png)
## Use the Tournament Feature to create, promote, and run tournaments from ggLeap: pick a format, collect signups, enter results, and share a live bracket.

This article is for admins and organizers.
## Find the Tournaments section
1. Sign in to ggLeap.
2. Scroll down the left sidebar and click **Tournaments** (below Events, with a medal icon).
![The Tournaments section in the sidebar](https://storage.crisp.chat/users/helpdesk/website/-/a/f/d/6/afd6941e8bc7d800/image_wp26q6.png)

The first visit shows the start-a-tournament screen.

![A section of the start tournament form](https://storage.crisp.chat/users/helpdesk/website/-/a/f/d/6/afd6941e8bc7d800/image_1tw90mo.png)

After that, you see a list of every tournament your center has started.

![List of previously started tournaments in ggLeap](https://storage.crisp.chat/users/helpdesk/website/-/a/f/d/6/afd6941e8bc7d800/image_w6bt3y.png)
## Create a tournament
1. Open **Tournaments** and start a new tournament.
2. Set the **Format**, **Seeding**, and **Games per match**.
3. Add the name, game, locations, and players.
4. Choose whether to enable **Signup link** and **Public tournament**.
5. Collect signups, then press **Start tournament**.

### Formats
| Format | How it works |
| ---- | ---- |
| Single Elimination | Knockout bracket; one loss eliminates a player |
| Single Elimination with Consolation | Single elimination, but players with a loss move into a consolation bracket |
| Double Elimination | Eliminated after two losses; one loss drops a player to a lower bracket |
| Round-robin | Every player plays every other player; ranked by wins |
| Swiss-system | Players face similarly performing opponents each round, no eliminations; winner by total points |
| Leaderboard | Points-based; players ranked by points accumulated over the competition |
| Ladder | Continuous competition where players challenge each other to move up in rank |
| Two-stage | Qualifier stage plus finals/playoff stage; the qualifier can be a group stage (groups > 1) where only top players per group advance |

### Seeding
| Method | How it works |
| ---- | ---- |
| Advantage | Most common. Higher seeds get a significant edge (8 players: 1 plays 8, 2 plays 7, 3 plays 6) |
| Equitable | Niche. Lower seeds get an easier path, narrowing the gap between seeds |
| Shuffle | Randomly places players in the bracket |

| Note: Round-robin and leaderboard formats have no seeding, since they do not need a prior ranking.

### Games per match (best-of)
Sets how many games are played in each matchup so you can score each game. 

| Note: If later rounds use a different number of games, set this to the maximum.

## Tournament details
| Setting | What it does |
| ---- | ---- |
| Name, game | Identify the tournament |
| Locations | Physical or virtual places where matches happen. Set only if you want them auto-assigned as the tournament progresses. Manual location management is planned for a future release |
| Signup link | Shareable link so players join with their player accounts. **Keep it checked** if players should link accounts to record results |
| Max players | Caps how many players can join |
| Require teams | Requires signup as a team; **Team size** sets the minimum team size |
| Signup period | When signups are allowed |
| Manual player entry | **Required if Signup link is unchecked** (there is no signup step). Optional if checked; added players pre-populate the signup list |
| Public tournament | Enables a landing page and lists the tournament in your Community Hub. Keep Signup link enabled with it, since signing up is the landing page call to action |
| Descriptive fields | Optional details used on the landing page and in the Community Hub |
| Start date, end date, Schedule matches | Enables scheduling individual matchups. An end date on a later day lets you set the specific day of each match |

## Accept signups
With Signup link checked, you manage a virtual signup sheet. Players sign up with their player accounts so results link to their profile.
You can also add guest players or teams (no account) manually by name.

![The sign-up sheet prior to starting the tournament](https://storage.crisp.chat/users/helpdesk/website/-/a/f/d/6/afd6941e8bc7d800/image_185feh3.png)

![The sign-up sheet with registered and approved participants (teams)](https://storage.crisp.chat/users/helpdesk/website/-/a/f/d/6/afd6941e8bc7d800/image_1bv8lci.png)
### QR code and link
Players scan the QR code or use the link to sign up with their ggLeap tournaments player profile. Their result is added to their account automatically.

| Note: With a public landing page, the sign-up link (not the QR code) points to the landing page.

### Review registration responses
1. Open the **Form Responses** tab to see all responses, including profile links, contact info, and custom field answers.
2. Responses not yet added appear in the **Pending** tab.
3. Press **Add** to make a response an official participant, or the **X** icon to discard spam.

![Adding a team form response to the tournament via the “Pending” tab](https://storage.crisp.chat/users/helpdesk/website/-/a/f/d/6/afd6941e8bc7d800/image_xbzybp.png)
### Edit before starting
Press **Edit details** on the sign-up page. Nearly every setting is editable, including format and structure.
You can also change the **Public tournament** toggle to finish edits before the tournament is visible.

![Editing tournament details](https://storage.crisp.chat/users/helpdesk/website/-/a/f/d/6/afd6941e8bc7d800/image_ssodaf.png)
## Configure the registration form
Every tournament with a signup link has a registration form with sensible defaults (full name and email are collected by default).
**Path:** Tournament > Edit details > Players & sign-ups > Configure custom fields & advanced settings.

![The “Configure custom fields & advanced settings” link in the “Players & sign-ups” section of the edit details page](https://storage.crisp.chat/users/helpdesk/website/-/a/f/d/6/afd6941e8bc7d800/image_basyn6.png)
### Custom fields
Select **Add Field** in the data collection section to add text fields, dropdowns, or yes/no questions. Press the trash can icon to remove a field.

||| **Warning:** Adding or removing fields does not affect data already collected. You can still view a registrant's answer to a removed field.

![Configuring custom form fields for a registration form](https://storage.crisp.chat/users/helpdesk/website/-/a/f/d/6/afd6941e8bc7d800/image_i4ycws.png)
### Advanced settings
| Setting | What it does |
| ---- | ---- |
| Require Sign-in | Blocks guest registration; players must be signed in to their player accounts |
| Sign-in methods (after Require Sign-in) | Email magic link (default), ggCircuit OAuth (account tied to your center), Discord OAuth, FACEIT OAuth. To limit registration to existing center accounts, select only ggCircuit OAuth |
| Email domains | Limits registration to listed domains, comma separated (example: `example.edu``, example.org`). Empty means any email can register |

||| Warning: Restricting sign-in methods or email domains adds friction and can lower registration conversion. Use these only for non-public events or when operations require it.

|| Important: Press Update registration form settings to save and apply changes.

![Configuring advanced settings for a registration form (configure with caution!)](https://storage.crisp.chat/users/helpdesk/website/-/a/f/d/6/afd6941e8bc7d800/image_1c1epuj.png)
## Promote with a landing page and the Community Hub
With **Public tournament** enabled, ggLeap generates a landing page from your tournament details. Its call to action is **Join tournament**, which opens your registration form.

| Item | Details |
| ---- | ---- |
| Hero image | Shown at the top of the landing page and as the thumbnail when the tournament is featured in the Community Hub. The tournament with the nearest start date is featured |
| Social sharing image | Used when the page is shared on social media or messaging apps, and as the thumbnail in the Community Hub tournament list |
| Description | Supports Markdown, but not every Markdown flavor. Preview the landing page before sharing widely. May show as plain text in some places |
| SEO and AI discoverability | Landing page includes HTML meta tags, OpenGraph metadata, and a SportsEvent JSON-LD schema. Fill in every descriptive field for best results |
| Community Hub link | On the main dashboard. The button is active only if at least one tournament is currently public; the link stays active afterward |

## Start the tournament
Press **Start tournament** to close signups and begin.

||| Warning: For seeded formats such as single and double elimination, order players by pre-rank (seed) before starting. Players are placed using the seeding method you chose at creation.
## Run the tournament
Initial matchups come from the format and seeding. An admin or organizer keeps score and selects winners. ggLeap determines later matchups automatically and suggests a match number and order to avoid bottlenecks.

![The full tournament view](https://storage.crisp.chat/users/helpdesk/website/-/a/f/d/6/afd6941e8bc7d800/image_oudgv3.png)
### Best-of series
If games per match is greater than 1, set the score for each game. Pressing **Player wins** finalizes the winner and updates the match record.

![A matchup card with tabs for setting the score for each game](https://storage.crisp.chat/users/helpdesk/website/-/a/f/d/6/afd6941e8bc7d800/image_wrekpq.png)
### Schedule matches
Requires a start date and **Schedule matches** checked at setup.
Scheduled times show in the read-only view.
For multi-day tournaments, matches also appear on the calendars of linked teams and player profiles.

If the end date is more than a day after the start date, you get a full date and time picker. Otherwise, you get a time picker only.

![Scheduling a match](https://storage.crisp.chat/users/helpdesk/website/-/a/f/d/6/afd6941e8bc7d800/image_90a6fu.png)
![A scheduled match](https://storage.crisp.chat/users/helpdesk/website/-/a/f/d/6/afd6941e8bc7d800/image_1pjt215.png)
### Share a live view

Press **Share** (top right) for sharing options, or right-click **Share** to open the read-only link directly. The view updates live as the tournament progresses, so you can show it on a TV or share it for mobile viewing. Players also see rankings, history, and metadata.

![The read-only view](https://storage.crisp.chat/users/helpdesk/website/-/a/f/d/6/afd6941e8bc7d800/image_18efla2.png)
### Show the bracket only
Click the expand icon (top right) to hide the matchup list and show only the bracket.

### Undo a result
Press **Undo** (top right) to reverse the last declared winner. Undos appear in tournament history and are announced in the live view.
For a tournament with a sign-up link, pressing **Undo** before any match update returns the tournament to the sign-up phase.

### Reset the tournament
Go to **View details** and press **Reset**.

||| Warning: Reset is irreversible. It clears the bracket and all results. Prefer Undo in most cases.

## Rankings and history
Press **View details** from the main tournament view. Rankings update as players are eliminated.
The same view shows history, metadata, and players, plus profiles for players who signed up with a ggLeap tournaments player account.

![Live rankings during the tournament](https://storage.crisp.chat/users/helpdesk/website/-/a/f/d/6/afd6941e8bc7d800/image_1ji3d1v.png)
![Final rankings after the tournament](https://storage.crisp.chat/users/helpdesk/website/-/a/f/d/6/afd6941e8bc7d800/image_w010eq.png)
## Export tournament data
Go to **View details** > **Export** and choose a format: JSON (canonical data format), JSON-LD (SportsEvent schema), or Excel workbook (`.xlsx`).

## Revisit past tournaments
Open the list under the **Tournaments** tab. Completed tournaments are included.
They stay available indefinitely through their read-only link and on the player profiles of participants, which show placement.

![The tournament list](https://storage.crisp.chat/users/helpdesk/website/-/a/f/d/6/afd6941e8bc7d800/image_xcz320.png)
## Tournament API
An API is available for integrating tournaments with other platforms. Contact tournament@ggcircuit.com  or api@tourneybit.com.

## Related articles
* [**What is the Tournament Feature in ggLeap?**](https://helpdesk.ggcircuit.com/en/article/what-is-the-tournament-feature-in-ggleap-7w69eu/)
* [**Managing player profiles and teams for tournaments in ggLeap**](https://helpdesk.ggcircuit.com/en/article/managing-player-profiles-for-tournaments-in-ggleap-ju9nko/)
* [**Running a league in ggLeap**](https://helpdesk.ggcircuit.com/en/article/running-a-league-in-ggleap-1k026l0/)