Español
中文
العربيةRunning a tournament in ggLeap
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
- Sign in to ggLeap.
- Scroll down the left sidebar and click Tournaments (below Events, with a medal icon).
The first visit shows the start-a-tournament screen.
After that, you see a list of every tournament your center has started.
Create a tournament
- Open Tournaments and start a new tournament.
- Set the Format, Seeding, and Games per match.
- Add the name, game, locations, and players.
- Choose whether to enable Signup link and Public tournament.
- 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 |
Games per match (best-of)
Sets how many games are played in each matchup so you can score each game.
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.
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.
Review registration responses
- Open the Form Responses tab to see all responses, including profile links, contact info, and custom field answers.
- Responses not yet added appear in the Pending tab.
- Press Add to make a response an official participant, or the X icon to discard spam.
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.
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.
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.
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 |
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.
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.
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.
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.
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.
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.
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.
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.
Tournament API
An API is available for integrating tournaments with other platforms. Contact tournament@ggcircuit.com or api@tourneybit.com.