Player Management

Learn how to add, manage, and organize players in your groups. This guide covers internal players, linked accounts, jersey numbers, photos, and roster management.

Beginner
8 minutes

Prerequisites

Before starting this tutorial, make sure you have:

  • A Balla Stats account
  • At least one group created
  • At least one team in your group
  • Admin or Owner role in the group
What You'll Learn
  • Navigate to player management
  • Understand player types
  • Add and link players
  • Manage jersey numbers and photos
  • View and manage rosters

New to Balla Stats? Start with the Quick Start Guide first.

1
Navigate to Players
  1. 1Log in to your Balla Stats account
  2. 2Navigate to your group from the sidebar
  3. 3Click on the "Players" tab in the group menu
  4. 4You will see a list of all players in your group
  5. 5Use the search bar to find specific players
2
Understanding Player Types

Balla Stats supports two types of players:

Internal Players

Players created without linking to a user account. They exist only within the group.

Best for:

  • Casual games with friends
  • Young players without accounts
  • Quick setup without invitations
Linked Players

Players linked to a Balla Stats user account via email.

Benefits:

  • Can view their own stats
  • Receive match notifications
  • Can update their own profile
  • Stats sync across groups
3
Adding an Internal Player

To add a player who does not have a Balla Stats account:

  1. 1Click the "Add Player" button
  2. 2Select "Create Internal Player"
  3. 3Fill in the player details:
  • Full Name: The player's display name (required)
  • Email: Optional, for future linking
  • Position: GK, DEF, MID, FWD (optional)
  • Jersey Number: 1-99 (optional)
  • Team: Assign to a team (optional)
  1. 4Click "Save Player"

The player has been added to your group and can be assigned to teams and included in match lineups.

4
Linking a Player to a User Account

To link a player to an existing Balla Stats user:

  1. 1Click "Add Player"
  2. 2Select "Link Existing User"
  3. 3Enter the user's email address
  4. 4Click "Send Link Request"

What Happens Next

  1. 1

    Request Sent

    The user receives a notification about the link request

  2. 2

    User Accepts

    The user accepts the link request from their dashboard

  3. 3

    Profile Connected

    The player profile is now connected to the user account

  4. 4

    Stats Sync

    All statistics are now visible on the user's profile

If the user does not have a Balla Stats account yet, create an internal player first and link them later when they sign up.

5
Adding Players to Teams

Once players are added to your group, assign them to teams:

  1. 1Go to the Teams page in your group
  2. 2Select the team you want to add players to
  3. 3Click "Manage Roster" or "Add Players"
  4. 4Select players from the group player list
  5. 5Click "Save" to confirm the roster changes
6
Editing Player Details

Internal Players

Admins can edit all fields for internal players:

  1. 1Navigate to the player's profile
  2. 2Click the "Edit" button
  3. 3Update the desired fields
  4. 4Click "Save Changes"

Linked Players

Editing is split between admins and the player themselves:

  • Admins can edit: Jersey number, position, and team assignment
  • Players can edit: Their own name, photo, and profile details

For linked players, some fields are controlled by the player themselves. Admins manage team-specific settings like jersey number and position.

7
Jersey Numbers

Best Practices

  • Unique per team: Each player on a team should have a unique number
  • Keep it consistent: Use the same numbers across seasons when possible
  • Traditional ranges: Goalkeepers 1 or 12-13, Defenders 2-6, Midfielders 7-11, Forwards 9-11
  • Valid range: Jersey numbers must be between 1 and 99

To change a player's jersey number:

  1. 1Go to the player's profile
  2. 2Click "Edit"
  3. 3Update the jersey number field
  4. 4The system will warn you if the number is already taken on the team
  5. 5Click "Save Changes"

Jersey numbers can also be set on a per-match basis during lineup selection, allowing players to wear different numbers in different matches.

8
Player Photos

Add player photos for easy identification and a professional look:

  1. 1Go to the player's profile
  2. 2Click on the photo area or "Upload Photo"
  3. 3Select an image from your device
  4. 4Crop and adjust the photo if needed
  • Supported formats: JPG, PNG, GIF
  • Maximum size: 5MB
  • Recommended: Square images (1:1 ratio) work best
  1. 5Click "Upload" to save
  2. 6The photo will appear across all match lineups and statistics

Photo Tips

For the best results with player photos:

  • Use a clear headshot or action photo
  • Ensure good lighting and contrast
  • Avoid group photos - use individual shots
  • Square crops display best across the platform
9
Viewing the Team Roster

Viewing a Team's Roster

  1. 1Navigate to the team page
  2. 2The roster shows all assigned players with their positions and jersey numbers
  3. 3Click on a player to view their full profile and statistics
10
Removing a Player

When to Remove a Player

  • Player has left the club or group
  • Duplicate player entry needs cleanup
  • Player was created by mistake
  • Player transferred to another group

To remove a player from your group:

  1. 1Go to the player's profile
  2. 2Click "Remove Player" or the delete button
  3. 3Confirm the removal in the dialog
Data Preserved
  • Match history remains intact
  • Statistics are kept in records
  • Match events stay in the timeline
  • Season standings are unaffected
  • Historical reports remain accurate
Data Lost
  • Player removed from active rosters
  • Cannot be selected for future lineups

Removing a player does not delete their historical data. All past match statistics and events are preserved for record keeping.

Common Scenarios

Youth Club Setup

Managing a youth football club with multiple age groups:

  1. 1. Create separate teams for each age group (U12, U14, U16)
  2. 2. Add all players as internal (most young players won't have accounts)
  3. 3. Assign jersey numbers following the club's numbering system
  4. 4. Upload team photos for easy identification during matches

Amateur League

Running an amateur league with registered teams:

  1. 1. Create teams for each club in the league
  2. 2. Have team captains link their accounts as linked players
  3. 3. Add remaining players as internal with jersey numbers
  4. 4. Use the roster management feature for transfers between teams

Pickup Games

Organizing regular pickup football with rotating players:

  1. 1. Create two teams (e.g., "Team A" and "Team B")
  2. 2. Add all regular players to the group
  3. 3. Enable player self-registration for matches
  4. 4. Assign players to teams before each match
  5. 5. Use flexible registration mode for easy team swapping
Troubleshooting

Invitation Link Not Working

  • Check that the invitation has not expired
  • Verify the usage limit has not been reached
  • Ensure the user has a verified email address
  • Try generating a new invitation code

Cannot Edit Player Details

  • Confirm you have Admin or Owner role
  • For linked players, some fields are controlled by the player
  • Check if the group is in read-only mode (subscription expired)

Duplicate Jersey Number Warning

  • Two players on the same team cannot share a jersey number
  • Change one player's number before saving
  • Players on different teams can have the same number
  • Match-specific jersey numbers override the default
Best Practices

Data Entry

  • Use consistent name formatting
  • Add positions for all players
  • Assign jersey numbers early
  • Upload photos when available

Team Organization

  • Keep rosters up to date
  • Review rosters before each season
  • Archive inactive players
  • Use teams to organize by group

Privacy

  • Only share necessary information
  • Respect player data preferences
  • Use private groups for sensitive data
  • Let players control their profiles

Well Done!

You now know how to manage players in Balla Stats. Your groups are ready for organized matches and comprehensive statistics tracking.

Next Steps

Continue learning with these related tutorials: