Data Migration
Import players, teams, and clubs from CSV files
Step 1
Download Template
Download the CSV template for the data type you want to import
Step 2
Fill in Data
Add your data to the template following the example format
Step 3
Upload & Import
Upload your file, preview the data, and confirm import
Import Players
Required fields: full_name, email
Optional fields: phone, date_of_birth, governing_body_id, preferred_hand (right/left/ambidextrous), team_name
Note: If team_name is provided, the player will be assigned to that team (team must exist first)
Optional fields: phone, date_of_birth, governing_body_id, preferred_hand (right/left/ambidextrous), team_name
Note: If team_name is provided, the player will be assigned to that team (team must exist first)
Import Guide & Best Practices
Recommended Import Order
- 1. Clubs: Import clubs first if you have multiple clubs
- 2. Teams: Import teams and link them to clubs
- 3. Players: Import players last and assign them to teams
CSV File Format Tips
- Use UTF-8 encoding for special characters
- Keep the header row exactly as shown in the template
- Don't include extra columns not in the template
- Use YYYY-MM-DD format for dates (e.g., 1990-05-15)
- Phone numbers can be in any format
- Email addresses must be valid
- Team/club names must match exactly (case-insensitive)
Common Issues
- Duplicate emails: Each player must have a unique email address
- Missing teams: Import teams before assigning players to them
- Invalid dates: Ensure dates are in YYYY-MM-DD format
- Special characters: Save your CSV with UTF-8 encoding
Pro Tip: Test with a small file first (2-3 records) to ensure the format is correct before importing your full dataset.
