User guide
Discover how to use BasketTournament, whether you are an organizer or a tournament spectator.
From the Tournaments page, click 'New tournament'. You will need to define the fundamental parameters: name, dates, format (group stage + elimination, or knockout only) and visibility (public or private).
The following parameters are final once the tournament is created and cannot be changed:
- The tournament format
- Group configuration (number of groups, teams per group, qualifying teams)
- The best-of format per knockout round
- Visibility (public or private)
- For Groups + Bracket tournaments, the combination (number of groups × qualifying teams per group) must result in 2, 4, 8 or 16 bracket teams. The form shows in real time whether your configuration is valid.
- The tournament must contain exactly (number of groups × teams per group) teams to start the group stage. If the count is wrong, add dummy teams (e.g. "Bye") and assign them losses.
From the tournament detail view, the Duplicate button (copy icon) lets you reuse an existing tournament's configuration. Choose to copy the configuration only or with all teams and players — ideal for recurring tournaments.
From the tournament detail view, add your teams one by one. For each team, enter its name, city, coach and colour. Then add players with their number, position, age and height.
If teams or players have already participated in a previous tournament, use the Import button to clone them in one click. You can import a team with or without its players. From the team detail view, you can also import players individually from other teams.
Once all teams are registered, click 'Start group stage'. The application automatically generates groups and randomly assigns teams.
After generation, you will be redirected to a review screen allowing you to confirm the random draw or proceed to manual arrangement.
If you choose manual arrangement, a drag-and-drop view opens. Drag teams from their current group to the group of your choice.
Each group shows a real-time counter. The Validate button is only active when all groups are complete.
Scheduling works in two steps: create time slots (court + time range), then assign matches to those slots.
Fill in the court name (required), start and end times, then click + Add slot. Each slot represents an available court over a time period. Slots appear as columns in the grid.
Unscheduled matches appear in the Unscheduled column on the left. Drag and drop each match into the desired slot column. You can also move a match back to the reserve by dragging it to the Unscheduled column.
The ✨ Automatic scheduling button generates an optimized schedule in seconds. Set the buffer between matches (e.g. 10 min) and choose whether to schedule this tournament only or all day's tournaments on the same slots. A quality score from 0 to 100 indicates the result quality.
The Reset button moves all unfinished matches back to the reserve (MatchDate = empty). You can choose to reset this tournament only or all tournaments of the day.
From the calendar or match detail view, click 'Enter score'. Use the + and − buttons to enter each team's score, then optionally fill in individual player statistics.
Group standings are automatically updated after each score entry.
From the Bracket view, a "Detailed score entry" button is available under each quick score form. It opens a modal window to enter individual player statistics (points, rebounds, assists, steals, blocks, fouls, minutes) without leaving the bracket.
When all group matches are complete, click 'Advance to knockout'. The application automatically qualifies the top N teams from each group and generates the bracket.
The seeding mode (random or by position) determines how qualified teams are placed in the bracket. This is set when creating the tournament.
The Bracket view shows the full tournament tree with connectors between rounds. For each series, enter scores match by match. The series winner automatically advances to the next round.
Best-of 3, 5 or 7 series end automatically once a team reaches the required number of wins.
BasketTournament allows you to export several PDF documents from different views of the application.
- Calendar PDF, from tournament detail: full list of matches with dates, teams and scores
- Standings PDF, from the Groups view: standings table for each group
- Bracket PDF, from the Bracket view: elimination tree with series results
- Player stats PDF, from tournament detail (organizer only): individual statistics for all players
- Match sheet PDF, from a finished match detail: score and detailed match statistics
From the Tournaments page, you can view all public tournaments without logging in. Click a tournament to access its detail page: registered teams, match schedule and general information.
The tournament list offers status filters (All, Draft, Group Stage, Knockout, Finished) to quickly find a tournament.
Private tournaments are hidden by default. To access one, click 'Access code' in the navigation bar and enter the 6-digit code provided by the organizer.
From a tournament detail view in the group stage, click 'Groups' to access standings. Each group shows a table with played, won, lost, points scored and point difference.
The Bracket view is accessible from the tournament detail once the knockout phase has started. It shows the full tree with series results, teams still in contention, and the path to the final.
From a team detail view, click a player to access their profile. You will find physical information (height, position, number) and average statistics per match: points, rebounds, assists, steals, blocks and minutes played.
Each player has a visual card displayed in the Players view. It shows their number, name vertically, height, position and average stats for the selected tournament. The silhouette is automatically chosen based on the player's gender and position.
Screen mode lets you display the tournament on a projector or large screen in the venue. It opens in a new tab from the "Screen mode" button on the tournament page (available once the tournament has started).
The search bar in the navbar lets you quickly find any tournament, team or player by name. Results are grouped by type and each row is a direct link to the corresponding page.
