Importing Rosters

This can be done on the web only.

This article covers roster imports and how to perform them.

Don't feel like entering each of your roster member's information one by one manually? That's strange because it sounds like a good time. Type typey type! Luckily there is an option for you to import your roster by uploading a .CSV file, so wipe that anxiety-induced bead of sweat from your brow and let's get started!

In this article

Team Roster Import File Setup

The first line of your file will be read as the column headings. The system will use the data from those fields to match to the fields in the TeamSnap roster profile. They should roughly match the fields in the player profile.

Up to 100 roster entries can be imported at once. For rosters over 100, please divide your roster into separate files for importing. 

Team Roster Import

With team imports, you can upload your file then map the data to TeamSnap roster fields, and ta-da! Instant roster. We even have a roster import template for you!

Upload the Roster File and Run the Import

  1. Login to on the web
  2. Click your profile name in the My Leagues and Teams dashboard
  3. Click the Roster tab
  4. Click Import Players
  5. Click Choose File
  6. Choose and open the file to import (.XLS, .XLSX or .CSV)
  7. Double check that all your fields are correctly mapped
    1. For each column of data, select the corresponding TeamSnap column name from the drop-downs. If you don’t want to import a column, or there is no match, select “No Match.” We’ll import only the data that has a matching column name. We promise!
    2. If any field mapping errors are displayed, correct the issues before attempting to proceed by clicking the field and correcting the information. The system will not import fields with a mapping error.
  8. Click Save Roster  
  9. Finally, you just need to invite your roster members to join the team!

Team to Team Roster Import

Starting a new team with some familiar faces? You can invite current or former teammates directly to your new roster using the import from another team tool. Organization administrators must have an admin profile on both the teams they are importing to and from. Commissioner profiles for sports organizations are not assigned to teams and will not see the option to import from another team. 

Note: The import players from another team function is only available to team admins (managers or owners) with a manager profile on the both the team to import players from and to. 
  1. Log into TeamSnap
  2. Click your roster name below the team you will be transferring to, to enter the team site from the dashboard
  3. Click the Roster tab
  4. Click Import From Another Team 
  5. Select the team to import from
  6. Select the names of the players within the team that you want to import
  7. Select/Deselect the checkbox to send invitations to join as desired
  8. Click Import # Players
  9. Click Send Invite to confirm sending the imported players invitations to join the team or click Don't Send to skip sending invitations
  10. All done! Your imported players will be displayed under the Roster tab as soon as the import has finished processing
Note: Information that is hidden from teams or marked 'private' on roster profiles will not be copied over.  

Organization Roster Import File Setup

Note: Planning to use registration? All right stop! Collaborate and listen....Members will be added via the registration process so you don't need to import them beforehand. Skip on over to our registration articles to get started!

It's important that all of your column headings match up with TeamSnap's league roster import template. For best results, we recommend downloading the template and plugging in your information.

Tip: You can add columns to match up with your existing custom fields as well. Before importing, make sure you have a custom field under the league Settings tab that has the exact name as the column in your import, and does not match the name of any other existing roster columns, default or custom profile fields. If there are two fields with the same name, this will create an error. Your column headings for those custom fields should match exactly with the custom field title that you set up, and be ordered after the Non-Player column and before the Email column in your import template.

Import file key:

P1 = Parent one
P2 = Parent Two
Non-Player = Enter Y for non-player (i.e. coach/manager), Enter N or leave blank for player.

When there is data in the P1 and P2 columns, the import will automatically create Additional Contacts in the player profile, as long as the Parent 1 and Parent 2 first names are populated on your import file. 

Tip: Birthdates for United States should be formatted: MM/DD/YYYY. Birthdates for organizations in Canada or other non-US countries should be formatted DD/MM/YYYY for import.

If your spreadsheet has any blank rows, you will want to make sure to remove them. To import your players directly to their team, you will want to include their team name in the “team” column.  Make sure that team name matches exactly how you have it set up in TeamSnap.  If you have divisions set up, you will need to include the division too.  Make sure the division name matches how you have it set up in TeamSnap as well.  If you have sub-divisions, you would put in the division name for the lowest level sub-division.

Note: The email address in the player email column is the first email to receive a roster invite. This address will need to accept the invite before the P1 and P2 emails can be sent invitations. If the player is unlikely to accept this invitation promptly or does not have a TeamSnap account, you may want to list a parent email in the player email column, and have the child's email listed as a secondary contact. 

Organization Roster Import

  1. Click the Members tab
  2. Click the Roster Imports button
  3. Click the Upload Import File button
  4. Click the Choose File button
  5. Select your import file and click Open
  6. Click Continue
  7. Click the Inspect button
    • Review a few imported records to ensure that the information is accurate and populating in the correct fields
    • Once satisfied, click Back to Roster Import
    • If the data is incorrect, click Import Later, make corrections to your import file and start back at step 5
  8. Click Create All Rosters to finish the import process

If you did not include data in the team column of the import file, you can assign members to their teams after the import by following the steps in the Assigning Members help article.

Getting stuck? Check out Tips and Tricks for Troubleshooting Roster Imports.

Did this answer your question? Thanks for the feedback There was a problem submitting your feedback. Please try again later.