Adding players to your BallerCam team roster is optional, but highly recommended. A complete roster improves the viewing experience, makes player tagging easier, supports player-specific stats and highlights, and can help Players connect their BallerCam account to the correct athlete profile.

You can add players individually or use Batch Import to upload an entire roster at once.

👥 Why Add Players to Your Roster?

Adding players helps you get more out of BallerCam.

With a roster, you can:

• Display player names and jersey numbers during games
• Attribute scoring plays and stats to specific players
• Generate player-specific clips and highlights
• Allow fans to follow or favorite individual athletes
• Keep team and player information organized
• Help eligible Players connect their BallerCam account to an existing athlete profile

For teams using the new Player workflow, accurate roster information can also help BallerCam verify a Player and automatically connect them to the correct athlete profile.

👤 Who Can Add or Manage Players?

The Creator can manage the team's roster.

Other team members can also manage the roster when they have Manage Roster permission.

For the new Player role, roster management is disabled by default:

The Creator can change a Player's permissions if they want that Player to help manage the roster. Custom Player permissions remain in place after refreshing the app or signing in again.

💡 Tip: Rather than giving every team member roster access, Creators can enable Manage Roster only for people who need to add or maintain player information.

➕ Adding Players Manually

Open your team and go to People to add or manage roster players. When adding a player individually, enter their information, including:

• First Name
• Last Name
• Jersey Number

Additional contact and player information may also be available, including:

• Birth Year
• Email
• Phone Number

The more accurate the roster information is, the easier it is to manage players and connect eligible Players with their athlete profiles.

📧 Why Accurate Email and Phone Information Matters

For teams with an uploaded roster, automatic Player matching requires both of the following:

• The Player's first and last names match the roster.
• Either their account email or their verified phone number exactly matches the corresponding roster information.

A matching email or phone number alone is not enough; both first and last names must also match. When these requirements are met:

• Team membership can be automatically approved.
• The athlete can automatically be followed.
• Athlete Profile ownership still requires the team Creator's approval.
• A pending Athlete Profile claim remains until the Creator approves it.

Best Practice

When adding or importing players:

• Use the same first and last names the Player uses on their BallerCam account.

• Use the Player's correct email whenever available
• Use the Player's correct phone number
• Avoid entering shared or placeholder contact information when individual information is available
• Review imported information before saving

Accurate contact information can reduce unnecessary pending Player requests later.

🔎 What Happens if the Player Information Doesn't Match?

If a Player's first or last name does not match the roster, or neither their email nor verified phone number matches, BallerCam cannot automatically match them. The Player may see:

Which Player Are You?

They can select their athlete from the roster, but both their:

• Team membership
• Athlete-profile claim

remain pending until the Creator approves the request.

BallerCam also avoids automatically selecting an athlete when the match is ambiguous. This helps prevent the wrong account from being associated with a rostered player.

🆕 What if the Player Isn't Already on the Roster?

If a Player joins a team that does not have an uploaded roster, BallerCam takes them to:

Add Yourself

Available account information can be prefilled, and BallerCam creates the necessary:

• Roster entry
• Athlete ownership request
• Team association
• BallerCam favorite

Because this player entry was created by the joining member rather than coming from a trusted uploaded roster, Creator approval is still required.

This makes it possible for Players to join even if you have not finished building your roster beforehand.

📥 Batch Importing a Team Roster

If you need to add multiple players, Batch Import is the fastest option.

Instead of entering players one at a time, you can import roster information from:

• Photos
• Screenshots
• Spreadsheets
• PDFs
• Other supported files

You can also enter roster information manually from a desktop computer.

📱 Where to Find Batch Import

Open your team and go to People, then choose Batch Import Roster. If your team does not have a roster yet, use Build Your Roster to get started.

Batch Import is available to users who have roster-management permission.

📷 Mobile Import Options

From the Roster Import screen, choose one of the available options.

Take Photo

Use your phone's camera to photograph:

• A printed roster
• Lineup sheet
• Team list
• Handwritten roster

Make sure the information is clearly visible and easy to read.

Choose from Gallery

Select an existing:

• Photo
• Screenshot
• Image of a roster

from your photo library.

Choose File

Upload a supported file from your device.

Supported file types include:

• CSV
• XLSX
• PDF
• PNG
• JPEG

Email Link

Select Email Link to send yourself a secure link to the desktop roster-import portal.

This can be helpful when your roster file is easier to manage from a computer.

💻 Using the Desktop Import Portal

Open the secure link from the email on your computer.

You can then choose between:

Upload File

Upload a supported roster file, including:

• CSV
• XLSX
• PDF
• PNG
• JPEG

Add Manually

Use the desktop table to enter players using your keyboard.

This option can be helpful when transferring roster information from another system or spreadsheet.

🤖 AI Roster Extraction

When you upload a photo, spreadsheet, PDF, or image, BallerCam may automatically extract the roster information for you.

Extracted information can include:

• First Name
• Last Name
• Jersey Number
• Birth Year
• Email
• Phone Number

Always review the extracted information before submitting the roster. Check first and last names, emails, and phone numbers carefully. Automatic Player matching requires matching first and last names plus either a matching account email or verified phone number.

This review is especially important for email and phone information, because exact trusted contact matches can later be used when eligible Players join and connect to athlete profiles.

✅ Preview and Validate Your Roster

Before saving an imported roster, BallerCam displays a preview.

Use this screen to:

• Review each player
• Correct extracted information
• Edit incorrect rows
• Resolve highlighted errors

• Verify jersey numbers. Jersey numbers can contain up to three characters, and leading zeros are preserved.

• Verify contact information
• Confirm your player total

For Batch Import, the required fields are:

• First Name
• Last Name

The Submit button remains unavailable until required errors are corrected.

👯 Duplicate Players

BallerCam checks imported players against athletes already on your roster.

If a player already exists, BallerCam may update that player's information instead of creating another roster entry.

Always review the preview before submitting to make sure the correct athlete is being updated.

🔐 Athlete Profile Ownership

Claiming an Athlete Profile requires the team Creator's approval, even when the Player's team membership is automatically approved.

A roster entry and ownership of an athlete profile are related, but they are not the same thing.

BallerCam protects an athlete profile that is already owned by another user.

If ownership already exists:

• Another user cannot claim or reassign that athlete
• A competing Player claim will not replace the current owner
• Claim Profile is hidden when another owner already exists

This helps prevent duplicate or conflicting athlete ownership.

👥 Players on Multiple Teams

A Player may appear on more than one team.

When the same athlete is associated with multiple teams, BallerCam can group those team associations under a single athlete profile, with separate tabs for each team.

This keeps the athlete's different team memberships organized without requiring a separate athlete profile for each team.

🧑 Adult Team Rosters

Adult teams have a simplified roster and membership experience because Parent/Guardian functionality does not apply.

For Adult teams:

• Parent/Guardian information is hidden
• Parent contact fields are hidden when editing an Adult athlete
• Players can join using the Player role
• Players without an uploaded roster go directly to Add Yourself
• Team invitations use Invite Players
• Parent-specific invitation options are removed

📏 Batch Import Limits and Requirements

Keep these limits in mind when importing a roster:

• Maximum 100 players per submission
• Maximum file size: 5 MB
• Secure desktop upload links expire after 48 hours
• Upload links are single-use for final submission

These limits apply to an individual import submission.

🛠️ Troubleshooting

My File Won't Upload

Check that:

• The file is under 5 MB
• The file uses a supported format
• The file is not corrupted

Supported formats include CSV, XLSX, PDF, PNG, and JPEG.

Some Player Information Was Extracted Incorrectly

Use the roster preview to edit the information before submitting.

Pay particular attention to:

• Player names
• Jersey numbers
• Emails
• Phone numbers
• Birth information

Correct contact information is especially useful for future Player matching.

My Email Link Expired

Return to the BallerCam app and request a new Email Link.

Desktop import links expire after 48 hours.

I Don't See Batch Import

Confirm that your BallerCam account has Manage Roster permission for the team.

Players do not have Manage Roster permission by default, although the Creator can enable it for an individual Player.

A Player's Join Request Is Still Pending

Check that the Player's first and last names match your roster and that either their account email or verified phone number also matches. If these requirements are not met, the Creator must review and approve the team membership request.

✅ Tips for Best Results

• Add your roster before the season or first game whenever possible.
• Include player names and jersey numbers.
• Add accurate email and phone information when available.
• Use clear, readable roster files or photos.
• Review all AI-extracted information before submitting.

• Automatic Player matching requires matching first and last names plus either a matching account email or verified phone number.

• Avoid creating duplicate athlete entries.
• Give Manage Roster permission only to trusted team members who need it.
• Keep your roster updated as players join, leave, or change jersey numbers.

✅ Key Reminders

• Adding a roster is optional, but it improves BallerCam's player, scoring, tagging, and highlight experience.
• Players can be added individually or with Batch Import.
• Batch Import supports CSV, XLSX, PDF, PNG, and JPEG.
• First Name and Last Name are required for Batch Import.

• Automatic Player matching requires matching first and last names plus either a matching account email or verified phone number.

• If BallerCam cannot match a Player, team membership requires Creator approval. Athlete Profile ownership requires Creator approval even when membership is automatically approved.

• Players have Manage Roster disabled by default.
• Existing athlete ownership is protected.
• Adult-team rosters do not use Parent/Guardian functionality.