How to Manually Add Players to Your Club Roster

Intro

BallersBook gives you two ways to bring players into your club. Parents can register their children through the public form at /add-player/:clubId, but as a Club Admin you may want full control over the data that enters your system. Manual addition lets you enter player details yourself, assign them to groups or seasons immediately, and avoid relying on parent submissions. This guide walks you through every step of the manual player creation process.

Prerequisites

• A Club Admin account (requires the manage_players permission or equivalent).
• Your club must already be set up in the system (a club_id document exists in Firestore).
• (Optional) Groups or seasons created if you want to assign the player right away.

Step-by-step

1. Log in to BallersBook with your Club Admin credentials. Make sure you have the Admin role active (use the Role Switcher in the Navbar if you have multiple roles).

2. Navigate to the Roster or Players page.

3. Click Add Player. A form modal or a new page opens.

4. Fill in the player’s details. The database schema defines these fields for the players collection:

Field	Required	Description
first_name	Yes	Player’s first name
last_name	Yes	Player’s last name
date_of_birth	Yes	Use the date picker (format: YYYY-MM-DD)
phone	No	Contact phone number
email	No	Email address (used for parent correspondence)
avatar_url	No	A URL to a profile image
notes	No	Internal notes (visible to club staff)

5. (Optional) Assign the player to a group. In the Groups section of the form, select one or more existing groups. If you haven’t created groups yet, you can leave this blank and assign later.

6. (Optional) Enroll the player in a season. Some clubs use the SEASON_PLAYER junction to track season‑specific data. If your club uses seasons, choose one from the dropdown and set the join date (defaults to today).

7. Click Save. The new player appears in your club’s roster instantly. A confirmation message is shown.

📸 Screenshot placeholders: If you have a screenshot of the Add Player form, insert it here with an alt text like “Add Player form with fields for first name, last name, date of birth, and optional groups.”

Tips & Pitfalls

• Check for duplicates before adding. The system does not automatically prevent duplicate names. Use the search bar on the Roster page to see if the player already exists.
• Date of birth format must be YYYY-MM-DD. The date picker enforces this, but if you paste data, verify the format.
• Phone numbers should include country code (e.g., +1234567890) for SMS features.
• Groups and seasons are optional but highly recommended for attendance tracking and billing. You can always assign them later from the player’s detail view.
• Public form alternative - If you prefer parents to handle data entry, you can share the link /add-player/:clubId with them. That form will add players to your club automatically. As a Club Admin, you can review and edit those entries afterward.
• ⚠️ Permissions: If you cannot see the Add Player button, ensure your active role includes the manage_players permission. Contact your Super Admin if needed.

Summary

You now know how to manually add players to your club roster without relying on the public registration form. The process takes just a few steps: navigate to the Roster page, click Add Player, fill in the essential fields, optionally assign groups and seasons, and save. Next, consider creating a season and assigning these players to it. Visit the Seasons page to set up a new season or enroll existing players.