Tournaments

Last updated

Overview

Tournaments are the foundation of how matches are organised in CrickTeams. Each tournament groups a set of matches under a league, with a defined start and end date, squad settings and assigned players.

The Tournaments page gives managers a central place to view, create, edit and manage all active and completed tournaments for your club.

To access the Tournaments page:

  1. Log in to CrickTeams as a Manager
  2. Click Tournaments from the left navigation menu
Screenshot pendingTournaments Page — Full Overviewmedia-id: e1cd8b22-7e17-4379-84de-948e0d3f4b3b Run npm run ingest-screenshots to pull this from Confluence and upload to Firebase Storage. Until then the placeholder ships to staging only.
The Tournaments page showing Active and Completed tabs, usage limit, search and the option to add a new tournament

Understanding the Tournaments Page

The Tournaments page has two tabs:

Active Tab

Shows all currently running tournaments. Each row displays the tournament name, start date and end date. Click on any tournament row to open its details.

Completed Tab

Shows all tournaments whose end date has passed. These are read-only and cannot have new matches added. All match history and player data is preserved for reference.

Screenshot pendingActive Tabmedia-id: 11a3105f-096b-47c8-9a69-a527eb587556 Run npm run ingest-screenshots to pull this from Confluence and upload to Firebase Storage. Until then the placeholder ships to staging only.
The Active tab — view current tournaments
Screenshot pendingCompleted Tabmedia-id: 587b3493-bf94-459b-a05f-b497e4dd85bf Run npm run ingest-screenshots to pull this from Confluence and upload to Firebase Storage. Until then the placeholder ships to staging only.
Switch between Active and Completed tabs to view current and past tournaments

Tournament Limit

Your CrickTeams plan includes a limit on the number of active tournaments you can have at the same time. Your current usage is shown at the top of the Tournaments page.

Screenshot pendingActive Tournaments Usage Barmedia-id: f73fba1f-fcd6-4745-a7cf-1deeb5bcafeb Run npm run ingest-screenshots to pull this from Confluence and upload to Firebase Storage. Until then the placeholder ships to staging only.
The progress bar shows how many active tournaments you are currently using out of your plan allowance
  • The progress bar shows how many active tournaments you have used out of your total plan allowance
  • If you reach your limit the + ADD TOURNAMENT button will be disabled
  • Completed tournaments do not count toward your active tournament limit
  • Upgrade your plan to increase the number of active tournaments you can run

Creating a Tournament

Managers can create a new tournament at any time as long as the active tournament limit has not been reached.

Step 1 — Open the Add Tournament form

  1. Go to Tournaments from the left navigation menu
  2. Click the + ADD TOURNAMENT button in the top right corner
  3. The Add Tournament form will open
Screenshot pending+ ADD TOURNAMENT Buttonmedia-id: 72cda19b-6b5d-4d2c-807e-e73340ad1b58 Run npm run ingest-screenshots to pull this from Confluence and upload to Firebase Storage. Until then the placeholder ships to staging only.
Click the + ADD TOURNAMENT button to open the Add Tournament form

Step 2 — Fill in tournament details

Complete the Add Tournament form with the following information:

FieldRequiredDescription
Tournament NameRequiredEnter the full name of the tournament
League NameRequiredSelect the league this tournament belongs to — choose from your custom leagues or CrickTeams Approved Leagues
Start DateRequiredEnter the tournament start date in MM/DD/YYYY format
End DateRequiredEnter the tournament end date in MM/DD/YYYY format — must be after the start date
CaptainOptionalSelect a captain from your club players — can be left blank and assigned later
Vice CaptainOptionalSelect a vice captain from your club players — can be left blank and assigned later
Min PlayersRequiredMinimum number of players required for matches in this tournament — defaults to 11
Max PlayersRequiredMaximum number of players allowed for matches in this tournament — defaults to 12
Screenshot pendingAdd Tournament Form — Emptymedia-id: b69f2533-d4c1-4fd6-87b5-d0ac4cd9dd46 Run npm run ingest-screenshots to pull this from Confluence and upload to Firebase Storage. Until then the placeholder ships to staging only.
The Add Tournament form — Tournament Name, League, Start Date and End Date are required. Captain and Vice Captain are optional
Screenshot pendingMobile — Add New Tournamentmedia-id: 4cfbb08c-66ff-4803-b41c-dae5a9425e94 Run npm run ingest-screenshots to pull this from Confluence and upload to Firebase Storage. Until then the placeholder ships to staging only.
The Add New Tournament form on mobile — same fields as the web app, optimised for touch input

Step 3 — Set Squad Size (Min and Max Players)

The Squad size settings control how many players are required and allowed for each match in this tournament.

  • Min Players: the minimum number of Yes responses needed before the Select Playing Team button appears on the match list — defaults to 11
  • Max Players: the maximum number of players a manager can select for the playing team — defaults to 12
  • Both values can be changed per individual match if needed — see the Matches help article for details
  • Values must be between 1 and 12 — Max Players must always be greater than or equal to Min Players

Step 4 — Save the tournament

  1. Once all required fields are filled in click Save
  2. The tournament appears on the Active tab of the Tournaments page
  3. Your Active Tournaments usage count increases by 1
  4. The tournament is now ready for players and matches to be added

Matches Per Tournament

Based on the subscription level, each tournament has a maximum number of matches that can be created within it. This limit is displayed at the top of the tournament detail page.

Screenshot pendingMatch Count on Tournament Detail Pagemedia-id: be597b0f-f726-4836-8d3b-35d665c2a793 Run npm run ingest-screenshots to pull this from Confluence and upload to Firebase Storage. Until then the placeholder ships to staging only.
The Matches counter shows how many matches have been created out of the maximum allowed for this tournament
  • The counter shows current matches / maximum allowed — for example 1/25 means 1 match created out of 25 allowed
  • The maximum number of matches per tournament depends on your subscription plan
  • Free = 10 matches/tournament, Pro = 25 matches/tournament, Premium = unlimited
  • Once you reach the match limit for a tournament you cannot add more matches to that tournament
  • This limit applies per tournament — you can still add matches to other active tournaments

Editing a Tournament

You can edit a tournament’s details at any time while it is active. This includes updating the tournament name, dates, captain, vice captain and squad size settings.

  1. Go to Tournaments from the left navigation menu
  2. Click on the tournament you want to edit — the tournament detail page opens
  3. Click the General tab on the left side of the detail page
  4. Update the fields you want to change
  5. Click Update to save your changes
Screenshot pendingTournament Detail — General Tabmedia-id: 1fbe2c50-27ad-4362-a146-715b61f99f38 Run npm run ingest-screenshots to pull this from Confluence and upload to Firebase Storage. Until then the placeholder ships to staging only.
The General tab on the tournament detail page — update any field and click Update to save changes
Screenshot pendingMobile — Tournament Details General Tabmedia-id: 56c27048-7a1f-4763-9ba7-562427813f9d Run npm run ingest-screenshots to pull this from Confluence and upload to Firebase Storage. Until then the placeholder ships to staging only.
The Tournament Details page on mobile — tap General tab to edit name, dates, captain, vice captain and squad size settings

Managing Tournament Players

The Players tab on the tournament detail page lets you manage which club members are part of this tournament’s squad. Only players added to the tournament roster will be available for selection when creating the playing team for a match.

Viewing the Tournament Roster

  1. Go to Tournaments and click on a tournament to open it
  2. Click the Players tab on the left side of the detail page
  3. The Update Roster screen shows all club members with checkboxes
  4. Checked players are part of the tournament roster
  5. Unchecked players are not included in this tournament
Screenshot pendingTournament Players Tab — Update Rostermedia-id: a09aebf8-8b6f-47d4-84a6-2ec971eeaedf Run npm run ingest-screenshots to pull this from Confluence and upload to Firebase Storage. Until then the placeholder ships to staging only.
The Players tab shows all club members — check the players you want to include in this tournament's roster
Screenshot pendingMobile — Tournament Players Tabmedia-id: 7362d073-1b68-4a1b-8373-f7f81d1c48d8 Run npm run ingest-screenshots to pull this from Confluence and upload to Firebase Storage. Until then the placeholder ships to staging only.
The tournament Players tab on mobile — check or uncheck players to manage the tournament roster

Adding Players to the Roster

  1. On the Players tab check the checkbox next to each player you want to include
  2. Use the Search by name bar to find a specific player quickly
  3. Click Update to save the roster
  4. The Selected Players counter at the top right updates to show the number of players in the roster

Adding a New Player to the Club

If a player does not appear in the roster list it means they have not yet been added to the club. You can add them directly from this screen:

  1. Click the + Add Player button at the bottom right of the Players tab
  2. Enter the player’s details and send the invite
  3. Once the player accepts the invite they will appear in the roster list

Removing Players from the Roster

  1. On the Players tab uncheck the checkbox next to the player you want to remove
  2. Click Update to save the changes
  3. The player will no longer appear in the playing team selection for this tournament’s matches

Searching for a Tournament

You can quickly find a tournament using the search bar at the top of the Tournaments page.

  1. Click the Search… bar at the top right of the Tournaments page
  2. Start typing the tournament name
  3. The list filters in real time to show matching results
  4. Click on the tournament you are looking for
Screenshot pendingSearch Bar in Usemedia-id: e08b1a77-81f3-4073-9575-9d19ee57af83 Run npm run ingest-screenshots to pull this from Confluence and upload to Firebase Storage. Until then the placeholder ships to staging only.
Type in the search bar to instantly filter tournaments by name

Completed Tournaments

A tournament moves to the Completed tab automatically once its end date has passed. Completed tournaments are read-only — all match history and player data is preserved.

What you can do with a Completed Tournament

  • View all matches played in the tournament
  • View player responses and attendance for each match
  • View the tournament roster and squad details
  • Reference scorecard URLs and match results

What you cannot do with a Completed Tournament

  • Add new matches to the tournament
  • Edit the tournament name, dates or squad settings
  • Update the player roster
Screenshot pendingCompleted Tournaments Tabmedia-id: 68c7bfb6-1daa-4695-a27e-ba2fcbf1a033 Run npm run ingest-screenshots to pull this from Confluence and upload to Firebase Storage. Until then the placeholder ships to staging only.
The Completed tab shows all past tournaments. Clicking on any tournament will display its match history and player data
Screenshot pendingMobile — Completed Tournamentsmedia-id: ed205f84-4049-4a9d-9347-407a00f51522 Run npm run ingest-screenshots to pull this from Confluence and upload to Firebase Storage. Until then the placeholder ships to staging only.
The Completed tab on mobile — tap any completed tournament to view its match history and player data

Validations

CrickTeams enforces the following rules when creating or editing a tournament.

Tournament Name and Dates

Errors

  • Leaving Tournament Name, League, Start Date or End Date empty
  • Setting an End Date that is before the Start Date
  • Entering an invalid date format — use MM/DD/YYYY

Squad Size Settings

Errors

  • Setting Max Players to a value less than Min Players
  • Setting Min Players or Max Players to 0 or below
  • Setting Min Players or Max Players to more than 12

Tournament Limit

Errors

  • Trying to create a new tournament when you have already reached your plan’s active tournament limit

Frequently Asked Questions

Can I create a tournament without assigning a Captain?

Yes. Captain and Vice Captain are optional when creating a tournament. You can leave them blank and assign them later by editing the tournament’s General tab. Matches can still be created and managed without a captain assigned.

Why can I not add more matches to my tournament?

You may have reached the match limit for that tournament. Check the Matches counter at the top right of the tournament detail page — for example 25/25 means you have used all available match slots. The match limit per tournament depends on your subscription plan.

Why do some players not appear in the playing team selection when I create a match?

Only players who are checked in the tournament roster (Players tab) appear in the playing team selection. Go to the tournament detail page, click the Players tab, check the missing player and click Update.

Can I edit a tournament after it is completed?

No. Completed tournaments are read-only and cannot be edited.

What happens to my tournaments when I downgrade my plan?

When your club downgrades your tournaments are soft locked based on when they were created. Your oldest tournaments remain unlocked up to the new plan’s active tournament limit and the most recently created ones become locked. For example: downgrading from Pro to Free (limit 2) with 5 tournaments means the 2 oldest stay unlocked and the 3 most recent are locked. Locked tournaments show a padlock icon. Upgrade to unlock them.

Can I change the Min and Max Players for a specific match without changing the whole tournament?

Yes. You can override the Min and Max Players at the individual match level when creating or editing a match. If you do not set a match-level override the match will use the tournament’s default values.

Can players see tournament information?

Players can see the matches associated with a tournament and their own availability responses. They cannot see or edit tournament settings, squad size settings, or manage the player roster.

How do I know when a tournament will move to the Completed tab?

A tournament automatically moves to the Completed tab once its End Date has passed. You do not need to do anything manually.

  • Matches — Create and manage matches within a tournament
  • Players — Invite and manage your club players
  • Grounds — Add and manage grounds for your matches
  • Subscription — Understand your plan features and limits