Overview

Matches are the core of every tournament in CrickTeams. Managers create matches for each tournament, assign grounds, track player availability and manage the playing team selection. Players can view upcoming matches, respond to availability and see match details from their dashboard.

This guide covers everything managers and players need to know about matches — from creating and editing, to availability tracking, ground selection, completed matches and locked matches.

To access the Matches page:

1. Log in to CrickTeams as a Manager or Player
2. Click Matches from the left navigation menu

📸Screenshot pendingMatches Page — Upcoming Tabmedia-id: eb6d99f6-3fb2-4ec6-bbed-b318f5fa08ed Run npm run ingest-screenshots to pull this from Confluence and upload to Firebase Storage. Until then the placeholder ships to staging only.

📸Screenshot pendingMobile — Match List Pagemedia-id: c95d4730-b25e-4db3-83e2-4eb5a8bde7f3 Run npm run ingest-screenshots to pull this from Confluence and upload to Firebase Storage. Until then the placeholder ships to staging only.

Understanding the Matches Page

The Matches page has two tabs and several filters to help you find and manage matches quickly.

Upcoming Tab

Shows all scheduled future matches. Each match row displays the opponent name, start date and time, ground name and address, availability count and a dropdown to set your own availability.

Completed Tab

Shows all matches whose date has passed. Managers can update the match result and add a match report on completed matches. Players can view the result and match details.

Tournament Filter

Use the tournament dropdown at the top right to filter matches by a specific tournament. This is useful when you have multiple active tournaments running at the same time.

List View

The List view dropdown lets you switch between a list layout and a calendar view. The calendar view displays matches on the dates they are scheduled, making it easy to see your match schedule at a glance.

Availability Badges

Each match row shows three availability badges:

Badge	Colour	Meaning
Yes Number	Green	Players who responded Yes — attending
No Number	Red	Players who responded No — not attending
Maybe Number	Orange	Players who responded Maybe — uncertain

Creating a Match

Only managers can create matches. Matches must be created within a tournament and are subject to the match limit of your subscription plan.

Step 1 — Open the Add Match form

1. Go to Matches from the left navigation menu
2. Click the + ADD MATCH button in the top right corner
3. The Add Match form will open

Step 2 — Fill in match details

Complete the Add Match form with the following information:

Field	Required	Description
Opponent Name	Required	Enter the name of the opposing team
Tournament Name	Required	Select the tournament this match belongs to — only active tournaments are shown
Location	Required	Click the Location field to open the ground picker — select from My Grounds, CrickTeams Approved Grounds or add a new ground via + Use Manual Address
Date	Required	Enter the match date in MM/DD/YYYY format
Time	Required	Enter the match start time
Scorecard URL	Optional	Enter a link to the scorecard if available — can be added after the match
Min Players	Required	Minimum Yes responses needed for the Select Playing Team button to appear — inherits from tournament by default
Max Players	Required	Maximum players that can be selected for the playing team — inherits from tournament by default
Umpiring 1 Contact	Optional	Enter umpire 1 name and contact details
Umpiring 2 Contact	Optional	Enter umpire 2 name and contact details
Additional Notes	Optional	Enter any pre-match notes — performance targets, strategies, etc.

📸Screenshot pendingMatch Detail View — Add or Edit Matchmedia-id: 9230f6f8-ea3a-4884-9309-aaf0088596dc Run npm run ingest-screenshots to pull this from Confluence and upload to Firebase Storage. Until then the placeholder ships to staging only.

📸Screenshot pendingMobile — Add / Edit Match Formmedia-id: 42f98abb-7d55-4dbc-9dc5-4f3577acbc3a Run npm run ingest-screenshots to pull this from Confluence and upload to Firebase Storage. Until then the placeholder ships to staging only.

Step 3 — Select a Ground

When you click the Location field the ground picker opens. You can:

• Select from My Grounds — your club’s custom grounds
• Select from CrickTeams Approved Grounds — pre-verified grounds available to all clubs
• Use the Filter by State dropdown to narrow the list by state
• Use the Search bar to find a specific ground by name
• Click + Use Manual Address to add a brand new ground directly from the match creation screen

📸Screenshot pendingGround Picker from Match Detailmedia-id: d7021a7d-ec11-4e9e-acce-6ce8109bb4cd Run npm run ingest-screenshots to pull this from Confluence and upload to Firebase Storage. Until then the placeholder ships to staging only.

Player Availability

Availability tracking is at the heart of match management in CrickTeams. All players in the tournament roster are automatically added to each match and can respond with Yes, No or Maybe.

How Players Set Their Availability

Players and managers can set availability in two ways:

From the Match List:

• Find the match on the Upcoming tab
• Use the Select Availability dropdown on the right side of the match row
• Select Yes, No or Maybe
• The availability badges update instantly

From the Match Detail:

• Click on the match row to open the match detail
• On the Detail View tab, use the Select Availability dropdown at the top
• Select Yes, No or Maybe

Viewing Player Responses

Managers can see the individual response of every player in the tournament roster by opening the match detail and clicking the Player Response tab.

1. Click on a match row to open the match detail
2. Click the Player Response tab at the top of the detail panel
3. View all players with their individual responses — Y (Yes), N (No) or M (Maybe)
4. Use the Yes, No and Maybe filter buttons at the top right to filter by response type
5. Click Save if you have made any changes to player responses as a manager

📸Screenshot pendingMatch Detail — Player Response Tabmedia-id: bd57cebb-f595-4068-960d-b12c18f05491 Run npm run ingest-screenshots to pull this from Confluence and upload to Firebase Storage. Until then the placeholder ships to staging only.

📸Screenshot pendingMobile — Player Availabilitymedia-id: 5f0e795f-baee-4ceb-9b97-3dbda62be233 Run npm run ingest-screenshots to pull this from Confluence and upload to Firebase Storage. Until then the placeholder ships to staging only.

Availability Count Updates

The green, red and orange availability badges on the match list update in real time as players respond. The manager can see at a glance how many players are available for each match without opening the detail.

Response Lock

Once the number of selected players in the playing team reaches the tournament’s Min Players value, player responses are automatically locked. Players can no longer change their availability once the playing team has been finalised.

Selecting the Playing Team

Once enough players have responded Yes, the manager can select the playing team for the match. The Select Playing Team button appears automatically when the number of Yes responses meets or exceeds the tournament’s Min Players value.

How to Select the Playing Team

1. On the Matches list, find the upcoming match
2. When the Yes count meets or exceeds Min Players the Select Playing Team button appears on the right side of the match row
3. Click Select Playing Team to open the player selection screen
4. Select the players you want in the playing team by checking their names
5. The counter at the top right shows Selected: X / Max Players — you cannot exceed the Max Players value
6. Assign Captain, Vice Captain and Wicket Keeper using the dropdowns at the top
7. Click Save to confirm the playing team

📸Screenshot pendingSelect Playing Team — Player Selection Screenmedia-id: 5c4b0665-e2a2-4104-b144-eab362ef23fe Run npm run ingest-screenshots to pull this from Confluence and upload to Firebase Storage. Until then the placeholder ships to staging only.

📸Screenshot pendingMobile — Select Playing Teammedia-id: 69019827-f220-4345-9a5b-ff4d20bc767e Run npm run ingest-screenshots to pull this from Confluence and upload to Firebase Storage. Until then the placeholder ships to staging only.

Share Playing XI Email

Once the number of selected players reaches or exceeds the Min Players value an email is automatically sent to all selected players with the playing team details. This notifies players that the team has been announced for the match.

Matches on the Dashboard

Both managers and players can see their next upcoming match directly on the Dashboard when they log in. This gives a quick summary without having to navigate to the Matches page.

What the Dashboard Shows

• The next scheduled match — opponent name, date, time, tournament and ground
• The current availability count for the match
• Select Availability dropdown to respond directly from the dashboard
• View all matches link to go to the full Matches page

📸Screenshot pendingDashboard — Upcoming Match Widgetmedia-id: 803e1846-b995-4166-a088-9b011e8287ab Run npm run ingest-screenshots to pull this from Confluence and upload to Firebase Storage. Until then the placeholder ships to staging only.

📸Screenshot pendingMobile — Player Dashboardmedia-id: 8186e4c5-213e-4f8d-b17f-73f2f49a35c5 Run npm run ingest-screenshots to pull this from Confluence and upload to Firebase Storage. Until then the placeholder ships to staging only.

Completed Matches

Once a match date has passed it moves automatically to the Completed tab. Managers can then update the match result and add a post-match report.

Updating a Completed Match

1. Go to Matches and click the Completed tab
2. Click on the match you want to update
3. The Match Report form opens
4. Set the Result — select Won, Lost, Draw, Tied or No Result from the dropdown
5. Add a Match Report — notes on umpiring, ground conditions, key moments, etc.
6. Add Additional Notes — performance observations, learnings, etc.
7. Click Save to update the match record

📸Screenshot pendingMatch Report — Completed Matchmedia-id: 38117229-6fc5-4c7a-979f-f1c0837b5e77 Run npm run ingest-screenshots to pull this from Confluence and upload to Firebase Storage. Until then the placeholder ships to staging only.

📸Screenshot pendingMobile — Completed Matchmedia-id: 6ae2c573-efe5-4f03-a0ee-346a3e97b380 Run npm run ingest-screenshots to pull this from Confluence and upload to Firebase Storage. Until then the placeholder ships to staging only.

Locked Matches

When your club downgrades to a lower subscription plan some matches may become locked. Locked matches belong to tournaments that are over the new plan’s limit.

📸Screenshot pendingLocked Matches Sectionmedia-id: b5e11009-f601-48bd-b175-3f3aa5c65722 Run npm run ingest-screenshots to pull this from Confluence and upload to Firebase Storage. Until then the placeholder ships to staging only.

📸Screenshot pendingMobile — Locked Matchesmedia-id: a2450ef9-7128-4f7c-90aa-797424e62be0 Run npm run ingest-screenshots to pull this from Confluence and upload to Firebase Storage. Until then the placeholder ships to staging only.

How Locked Matches Work

• Matches belonging to the most recently created tournaments become locked. When a club downgrades its plan, matches belonging to the oldest tournaments remain unlocked up to the new plan’s tournament limit
• Locked matches are shown at the bottom of the list with a padlock icon and dimmed appearance
• Players also cannot see or access locked matches — a message will display ‘To unlock matches simply upgrade your plan back to a higher tier’

Manager View vs Player View

Managers and players have different levels of access to match features. The table below summarises the key differences:

Manager View	Player View
Can create matches	Cannot create matches
Can edit all match details	Can only view match details
Can update availability for all players	Can only update own availability
Can view Player Response tab with all responses	Cannot view other players individual responses
Can select the playing team	Cannot select playing team
Can update result on completed matches	Can view result on completed matches
Can add match report and notes	Can view match report and notes
Can see locked matches with lock icon	Cannot see locked matches at all

Validations

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

Required Fields

Errors

• Leaving Opponent Name, Tournament, Location, Date or Time empty
• Entering an invalid date format — use MM/DD/YYYY
• Setting a match date before the tournament start date or after the tournament end date

Squad Size

Errors

• Setting Max Players to a value less than Min Players
• Setting Min Players or Max Players below 1 or above 12

Match Limit

Errors

• Trying to create a match when the tournament has reached its maximum match limit — check the Matches X/Y counter on the tournament detail page
• Trying to create a match in a completed tournament

Playing Team Selection

Errors

• Trying to select more players than the Max Players value for the match
• The Select Playing Team button will not appear until the Yes count meets or exceeds Min Players

Frequently Asked Questions

Why is the Select Playing Team button not showing?

The button only appears when the number of players who responded Yes is equal to or greater than the Min Players value for the match. Check the current Yes count on the match row and ask more players to respond.

Why is a player not showing in the playing team selection screen?

Only players who are in the tournament roster 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 change the ground after a match is created?

Yes. Open the match detail, click the Location field and select a different ground or add a new one via + Use Manual Address. The ground will update immediately and players will see the new location.

Can players change their availability after the playing team is selected?

No. Once the selected player count reaches the Min Players value, player responses are locked and cannot be changed. This prevents last-minute changes after the playing team has been announced.

What happens to matches when I downgrade my plan?

Matches belonging to your most recently created tournaments become locked when you downgrade. Only matches in your oldest tournaments (up to your new plan’s limit) remain accessible. Upgrade your plan to regain access to locked matches.

Can players see who else is attending a match?

Players can see the overall availability count (Yes/No/Maybe badges) on the match list but cannot see individual player responses. Only managers can view the full Player Response tab with individual responses.

How do I know which tournament a match belongs to?

The tournament name is shown on the match detail page. On the match list you can use the tournament filter dropdown at the top right to filter matches by tournament.

Can I add a scorecard URL after the match is played?

Yes. Open the completed match from the Completed tab and add or update the Scorecard URL field. Click Save to update the record.

When does a match move to the Completed tab?

A match moves to the Completed tab automatically once its date and time has passed. You do not need to do anything manually — it happens automatically.

Related articles

• Tournaments — Create and manage tournaments and rosters
• Grounds — Add and manage grounds for your matches
• Practices — Create and manage practice sessions
• Subscription — Understand your plan features and limits