BOWLING-TOURNAMENTSDOCS
Documentation
On this page

Brackets documentation

How directors run single-elimination brackets in the app: eight-player trees, scores as the source of truth, regular vs reverse game mapping, ties, chops, and manual fixes.

Directors

Brackets

Directors manage brackets from the tournament workspace: open a tournament from the tournaments list, use Edit Scores for rosters and game scores, then Edit Brackets at a path like /dashboard/tournaments/[tournamentId]/brackets.

What a bracket is

  • Each bracket uses eight roster slots (bowlers from the squad roster on Edit Scores).
  • The app builds a fixed single-elimination tree: four pairings, then two matches, then one final. A bowler must win three stages to win the bracket.
  • You can use a bracket pool (entries and shuffle) or create brackets from the roster; the tree is the same once eight slots are set.

How winners are filled from scores

Game scores on Edit Scores are the source of truth. On the brackets workspace, under View All Brackets, use Update from Scores. The app compares numeric game scores for each pairing and sets match winners when it can decide them.

Regular vs reverse bracket mode

The bracket pool has a mode that maps each round to a numbered game on the score sheet:

  • Regular: round 1 uses Game 1, round 2 uses Game 2, the final uses Game 3.
  • Reverse: round 1 uses Game 3, round 2 uses Game 2, the final uses Game 1.

Ties before the final

If the primary game for that round is a tie, or a score is missing for one bowler, the app tries additional games in a fixed order—only when both bowlers have a numeric score for that game. If nothing breaks the tie, that match stays undecided (no automatic winner).

  • Round 1: regular tries Game 1, then 2, then 3; reverse tries Game 3, then 2, then 1.
  • Round 2: regular tries Game 2 then Game 3; reverse tries Game 2 then Game 1.

Early rounds never split the pot; they only pick a winner when scores distinguish the pair.

Tie in the final (chop)

If the deciding game for the final has scores for both finalists and those scores are equal, the app records a chop: two co-winners and no single winner on that final match. The bracket view shows both names and the full bracket pot split in half for each co-winner (multi-place payout presets are not used for that chop display).

Manual changes

Where the director UI lets you set winners by hand, doing so clears an automatic chop so you can correct mistakes.

Flow overview

Edit Scores (roster + games) → Edit Brackets → View All Brackets → Update from Scores → winners / chop

Questions? Contact us.