Docs/Roster Management

Roster Management

Add wrestlers, import from spreadsheets, handle season transitions, and understand roster limits.

Adding Wrestlers

From your club dashboard, open the People tab and click Add Wrestler. Enter the wrestler's name and, optionally, their weight class and email address.

The email field links the roster entry to a user account. When that user logs in, they can see match recordings tagged to their name. If you do not have an email, you can add it later.

CSV Import

Click Import CSV on the People page. Your CSV file needs at minimum a wrestler_name column. Recognized columns:

wrestler_id -- Present automatically in your own exports. Matches an existing wrestler on this club's roster so the row updates that wrestler instead of creating a new one.
wrestler_name -- Required. Full name of the wrestler.
user_email -- Optional. Sends an invite email that links the entry to a user account once accepted -- it does not add the wrestler directly. MatViz's own export always leaves this column blank, even for wrestlers who already have a linked account -- leave it blank when re-importing your own export.
birth_date, grade, gender, weight, weight_class -- Optional profile fields.
guardian_name, guardian_phone, guardian_email, emergency_name, emergency_phone -- Optional contact fields.
usaw_number, usaw_expires, aau_number, aau_expires -- Optional membership tracking (self-reported -- not verified against USAW or AAU).
subgroup -- Optional, Program and Elite plans only. One of varsity, jv, or girls.
groups -- Optional. Semicolon-separated group names, matched against groups you have already created.

Re-importing a file this club exported updates the matching wrestlers in place -- it does not create duplicates, because the export always includes each wrestler's wrestler_id. If a matched wrestler was archived, re-importing brings them back to active status. A row with no wrestler_id -- for example, a spreadsheet from another system -- always creates a new wrestler, even if the name matches one you already have. A row that HAS a wrestler_id but it doesn't match a wrestler on this club's roster is skipped, not imported -- it is never used to create a new wrestler, to avoid creating a duplicate under a different identity. This matters most when importing one club's export into another club: every row will skip rather than create. After importing, check the summary for how many rows were added, updated, or skipped (for example, if reactivating a wrestler would put you over your plan's wrestler limit, or if a wrestler_id didn't match) so nothing is missed.

wrestler_name is only used to create a new wrestler -- editing the name column in an exported file and re-importing it does not rename the existing wrestler. To rename someone already on your roster, use the People page.

On a row updating an existing wrestler (one with a matching wrestler_id), a blank cell leaves that field's existing value unchanged -- it does not clear it, and a blank groups cell does not remove the wrestler from any group they already belong to. To clear a field, remove a USAW/AAU membership number, or take a wrestler out of a group, use the People page instead.

CSV Export

Click Export CSV to download your current roster as a spreadsheet. This is useful for your own backup or as a starting point when starting next season.

This file includes guardian and emergency contact details for your wrestlers -- most of whom are minors. Treat it like any other sensitive record: keep it to your coaching staff and don't share it with tournament organizers or anyone outside your club as-is.

The export includes each wrestler's wrestler_id. Edit the file -- add a birth date, update a weight, record a membership number -- and re-import it, and each row updates the matching wrestler instead of creating a duplicate. (Names are not updated this way -- see CSV Import above.)

Seasons

Your club has a current season, shown at the top of the People page. When a family registers, or you add a wrestler on People, that wrestler goes on the roster for the current season automatically -- there is no separate step.

The People page defaults to the current season. Use the season picker to look at a past season's roster -- it is read-only, showing exactly who was on the roster that season and when they joined or left. Past seasons never disappear: match recordings and every wrestler's season history remain searchable.

When it's time to move to a new season, click Start next season on Command Center or People. It opens the season form prefilled with next year's dates. A saved new season becomes current once its start date (or preseason) arrives, or as soon as the previous season's end date passes, whichever comes first. New roster activity attaches to whichever season is current. Wrestlers from the prior season are not archived automatically; archive anyone who is done for the year from People (including from a past season's view) whenever you're ready.

A wrestler's profile has its own Seasons section, showing every season they've belonged to, with controls to add them to the current season or remove them from it.

Roster Caps

Each plan has a roster limit:

Starter -- 30 active wrestlers
Program -- 75 active wrestlers
Elite -- No cap

Only active (non-archived) wrestlers count toward the cap. When you hit the limit, new additions are blocked until you remove wrestlers or upgrade your plan.