Double Elimination Brackets
In a double elimination tournament, a competitor must lose two matches to be eliminated. This creates two parallel brackets — a Winner Bracket for competitors who have not yet lost, and a Loser Bracket for competitors who have lost once. The champions of each bracket meet in a Final Bracket.
This feature is part of SportsPress Pro.
Setting the Format
When creating or editing a tournament, open the Details meta box and set Format to Double Elimination. The main content area then shows three separate meta boxes:
Winner Bracket
Loser Bracket
Final Bracket
The generic Bracket meta box used for single elimination is hidden when double elimination is selected.
How the Three Brackets Work
Winner Bracket
The Winner Bracket behaves exactly like a single elimination bracket. Teams that win every match stay here. The data for this bracket is stored in the same sp_event meta key as a single elimination tournament. The bracket editor, round labels, team assignment, and result entry work identically to single elimination.
Loser Bracket
The Loser Bracket receives teams that have lost one match in the Winner Bracket. Its data is stored separately under the sp_loser meta key. The bracket editor is the same table layout as the Winner Bracket, with its own set of round-label fields and match slots.
Because the Loser Bracket has a specific structure — losers feed into it in a staggered pattern — alternate match slots in the first round of the Loser Bracket are automatically hidden. These hidden slots represent the "bye" positions where the incoming losers have no immediate opponent from within the Loser Bracket. The hidden/forced slots are not displayed on the frontend.
Final Bracket
The Final Bracket is where the Winner Bracket champion faces the Loser Bracket champion. Its data is stored under the sp_final meta key. The Final Bracket editor shows only the relevant match slots; other positions in the grid are hidden automatically based on the rounds count.
Rounds and Team Capacity
Double elimination uses the same Teams selector in the Details meta box as single elimination. The selector controls the number of rounds, which determines the starting team capacity:
Teams setting | Rounds | Starting team slots |
3–4 teams | 2 | 4 |
5–8 teams | 3 | 8 |
9–16 teams | 4 | 16 |
17–32 teams | 5 | 32 |
33–64 teams | 6 | 64 |
The rounds limit applies equally to double elimination: the same sp_tournament_rounds_limit filter (default 6) caps both formats. There is no separate hard limit for double elimination in the source code.
Setting Up a Double Elimination Tournament
Go to Events > Tournaments > Add New.
Enter a title.
In the Details meta box, set Format to Double Elimination.
Set Teams to the range that covers the number of participating teams.
Optionally assign a League and Season to filter team dropdowns.
In the Winner Bracket meta box, assign teams to the first-round slots using the dropdown selectors.
Optionally enter dates and times for first-round matches.
Click Publish or Update. SportsPress creates events for all filled slots.
Entering Results and Propagating Winners
Enter results in the Results fields of each bracket editor in the same way as single elimination — two score fields per match separated by a dash. When you save, the winner of each match is determined from the event outcome configuration and automatically placed into the next available slot.
A team that wins in the Winner Bracket advances to the next Winner Bracket round.
A team that loses in the Winner Bracket is moved to the corresponding position in the Loser Bracket. You must enter the team manually in the Loser Bracket slot (the system determines who advances once results exist; the losing team does not move automatically between separate bracket sections on save — enter the teams in the Loser Bracket to match who actually dropped from the Winner Bracket).
Teams that win in the Loser Bracket advance through the Loser Bracket rounds.
The Loser Bracket champion and the Winner Bracket champion appear in the Final Bracket.
Round Labels
Each bracket (Winner, Loser, Final) has its own set of editable round-label fields in the table header. Labels for each bracket are stored independently (sp_labels for the Winner Bracket, sp_loser_labels for the Loser Bracket, sp_final_labels for the Final Bracket).
Frontend Display
On the tournament page, the three brackets are rendered in sequence with heading labels:
Winner Bracket (labeled "Winner Bracket")
Loser Bracket (labeled "Loser Bracket")
Final Bracket (labeled "Final Bracket")
These section headings come from the translatable strings registered in the text options (__( 'Winner Bracket', 'sportspress' ), etc.) and can be customized under SportsPress > Settings > Text.
The Winner panel (tournament champion), bracket sections, and group tables appear in this order on the page:
Winner (if set)
All three brackets
Groups (if any league tables are linked)
Each bracket section renders as an HTML table identical in structure to the single elimination display. The same display options apply — logos, venue, event links, team links, and layout (Default or Center).
The [tournament_bracket] Shortcode
The [tournament_bracket] shortcode works the same way for double elimination. It detects the tournament type automatically and renders all three bracket sections:
[tournament_bracket id="123"]
All shortcode attributes described in the single elimination article apply here as well (show_logos, show_venue, link_teams, link_events, responsive, layout).
Display Settings
The same global settings under SportsPress > Settings > Events > Tournaments apply to double elimination brackets:
Display logos — show team logos in event cells (default:
yes).Display venue — show venue name below the score (default:
no).Display winner — show the designated winner panel above the brackets (default:
yes).
Limits
Maximum rounds: 6 (same as single elimination; controlled by
apply_filters( 'sp_tournament_rounds_limit', 6 ))Maximum starting teams: 64
The round limit applies to each individual bracket section; all three brackets share the same
sp_roundsvalue
