Loading navigation

Help Center

Guides and documentation for club owners and administrators

League Setup

10 min readEvents

Leagues are multi-week competitions owned by your organization. This guide walks through every stage of running a league, from initial creation through scoring matches and completing the season.

Creating a New League

Navigate to Leagues in the admin sidebar and click the New league button. This opens the league creation page, which is split into two sections: League Details and Schedule Configuration.

League Details

1

League Name (required)

Enter a descriptive name such as "Spring Basketball League 2025". This name appears on the public league page and in registration lists.

2

Sport (required)

Select the sport from the dropdown. The available options come from your platform's configured sports list.

3

Description

Provide details about the league such as skill level, format, age group, or any other information that helps potential participants decide whether to register.

4

Start Date and End Date (required)

Use the date pickers to set the season window. The start date determines when matches can begin, and the end date sets the final week of play. These dates are also used by the schedule generator.

5

Entry Fee

Set the registration fee in cents. For example, enter 5000 for a $50.00 fee. Leave at 0 for a free league. The fee is displayed on the public league page.

6

Max Teams

Set a cap on the number of teams that can register. Leave empty or set to 0 for unlimited registrations.

7

Rules

Enter any league-specific rules and regulations. This text area supports free-form content and is visible to participants on the public league page.

Schedule Configuration

The schedule configuration controls how the system automatically generates matches when you start the league. All of these settings should be finalized before starting the league.

1

Match Days

Click the day toggles (Mon through Sun) to select which days of the week matches will be played. Selected days highlight in green. You can choose multiple days.

2

Start Time

Set the time of day when the first match begins using the time picker. Defaults to 7:00 PM. Subsequent matches on the same day are scheduled based on the game duration.

3

Game Duration (minutes)

Enter how long each match slot lasts in minutes. Defaults to 60. Accepts increments of 15 minutes. This determines the spacing between consecutive matches.

4

Number of Courts

Set how many courts are available for simultaneous play. More courts means more matches can run in parallel on a given day, resulting in fewer total match days needed.

5

Odd Team Handling

Choose what happens when there is an odd number of teams in a round:

  • Bye — one team sits out each round
  • Double Header — one team plays a bonus match to fill the gap
6

Match Format

Select the format for each match:

  • Single Game — one game per match
  • Best of 3 — first to win 2 sets
  • Best of 5 — first to win 3 sets

When everything looks good, click Create League. You will be redirected to the league management page where you can manage teams, registrations, and eventually start the season.

Plan your schedule early

Configure schedule settings before teams register. This way, you can share the expected match days and times with potential participants during the registration period.

League Statuses and Lifecycle

Every league moves through a defined lifecycle. The current status and schedule status are shown as badges at the top of the league management page.

  • Upcoming + Draft — The league has been created and is accepting configuration changes. Teams can register. No matches exist yet.
  • Active + Generated — The league has been started and all matches have been generated. Scores can be entered and standings update automatically.
  • Completed — The season is finished. Final standings are locked in.

Editing League Settings

Click Edit on any league card from the leagues list to open the league management page. The page is organized into five tabs:

  • Settings — Edit league details and schedule configuration
  • Registrations — View teams and players who have registered
  • Schedule — View all generated matches
  • Standings — View current team rankings (wins, losses, ties, points)
  • Data Management — Manually add/remove teams, create matches, and enter scores

Edit any league details or schedule settings in the Settings tab, then click Save Changes.

Managing Teams

Teams can join a league in two ways: self-registration through the public league page, or manual addition by an admin through the Data Management tab.

Adding Teams Manually

1

Open the Data Management tab

Go to the league management page and click the Data Management tab. The League Teams section shows all currently registered teams.

2

Click "Add Team"

A dialog appears with two options: select an existing team from the dropdown, or toggle Create new team to enter a new team name directly.

3

Confirm the addition

Click Add Team to register the team. Teams added by an admin are tagged with an "Admin" badge to distinguish them from self-registered teams.

Removing a team from a league will also delete any matches involving that team. A confirmation dialog warns you before proceeding.

Starting the League

Once teams have registered and your schedule configuration is finalized, you can start the league from the leagues list page. Leagues with a "Draft" schedule status display a Start League button.

1

Click "Start League"

On the leagues list page, find the league and click the blue Start League button.

2

Confirm the action

A browser confirmation dialog appears with the message: "Start league? This will generate all matches based on your schedule configuration and registered teams." Click OK to proceed.

3

Matches are generated

The system automatically creates all round-robin matches based on your schedule configuration, registered teams, match days, court availability, and date range. The schedule status changes from "Draft" to "Generated".

Starting a league generates all matches

This action uses the current schedule configuration and registered teams to generate the full match schedule. Make sure all teams are registered and your schedule settings are correct before starting. While you can reset the schedule later using the Reset Schedule button, this will delete all matches and standings data.

Scoring Matches

After starting a league, you can enter scores for each match. There are two scoring workflows depending on the match format.

Single Game Scoring

For single-game matches, click the Score button next to the match in the Data Management tab. A scoring dialog appears showing both team names with large score inputs. Enter the home and away scores, then click Save Score. Standings update automatically.

Best-of-3 / Best-of-5 Scoring

For multi-set matches, clicking Score navigates to a dedicated match scoring page where you can record individual set scores. The match status changes to "In Progress" as sets are played, and the overall set count is displayed on the match list.

Saving scores automatically recalculates the standings table. You can view updated rankings in the Standings tab at any time. The standings table shows wins, losses, ties, and total points for each team.

Editing and Deleting Matches

In the Data Management tab, each match row has edit and delete buttons:

  • Edit (pencil icon) — Opens a dialog to update the scheduled date and time, location, home/away scores, and notes.
  • Delete (trash icon) — Removes the match after confirmation. If the match was already completed, standings are recalculated.

You can also manually create additional matches using the Add Match button in the Data Management tab. Select the home and away teams, optionally set a date/time and location, then click Create Match.

Resetting the Schedule

If you need to regenerate the match schedule (for example, after adding or removing teams), use the Reset Schedule button that appears at the top of the league management page when the schedule has already been generated.

Reset deletes all match data

Resetting the schedule deletes all matches and standings. You will need to start the league again to regenerate the schedule. This confirmation dialog warns: "This will delete all matches and standings."

Viewing the Public League Page

Each league has a public page where members can view details, register, and follow the season. From the leagues list, click View public page to open it in a new tab. This is the page your members see when they browse or register for the league.

Tips for Running a Successful League

  • Set up your courts before creating a league. The number of available courts directly affects how many matches can run simultaneously.
  • Allow a registration window of at least 1-2 weeks before the start date so teams have time to sign up.
  • Double-check your schedule configuration before starting the league. Verify the match days, start time, and game duration match your facility's availability.
  • Enter scores promptly after each match. This keeps standings current and keeps participants engaged.
  • Use the description and rules fields to clearly communicate expectations, skill levels, and any house rules to participants.

Related Articles