# Import gymnasts CSV

You have a roster in a spreadsheet and you want to get everyone into Gym Art Meets without typing each name by hand. The CSV import tool is how you do it. It handles different date formats, column separators, and even lets you paste data straight from your spreadsheet.

This usually takes about five minutes, depending on how clean your data is.

This page covers the generic CSV import for your **club roster**. If you're trying to pull gymnasts out of a KSIS or MeetMaker export to set up a **meet**, use the meet-level importer instead: [Import from KSIS](/migration/import-from-ksis.md) or [Import from MeetMaker](/migration/import-from-meetmaker.md). They know the file shapes those systems produce and create the meet, levels, and competitions along with the gymnasts.

## Prerequisites

* You have a club in Gym Art Meets. If not, [create one first](/club-management/create-a-club.md).
* Your gymnast data is in a spreadsheet (Excel, Google Sheets, or a CSV file).

## Steps

### Step 1: Prepare your data

1. From your Club Dashboard, click **Gymnasts** in the sidebar.
2. Click **Add Many** in the top action bar.
3. You'll land on **Step 1** of the import wizard.
4. Grab the template. You have two options:
   * **Download CSV Template** to get a pre-formatted file you can fill in
   * **Copy Template to Clipboard** and paste it into your spreadsheet app
5. Fill in the template with your gymnasts. See [CSV template and format](/club-management/csv-template-and-format.md) for exactly what goes in each column.
6. Load your data back into Gym Art Meets. Three ways to do this:
   * **Upload a file** by clicking the upload area
   * **Paste from clipboard** by copying your spreadsheet data and pasting it in
   * **Drag and drop** the CSV file onto the import area

### Step 2: Verify and fix

1. Gym Art Meets parses your data and shows it in a table.
2. Each row is one gymnast, with a validation status next to it.
3. Rows with problems are highlighted. Use the **filter chips** at the top to see only the errors.
4. Click any row to open the **Edit Drawer** where you can fix missing fields, correct dates, or pick the right discipline from a dropdown.
5. The stats bar at the top shows your total count and error count. Watch both numbers.
6. Fix everything before moving on.

### Step 3: Import

1. Once all rows are clean (zero errors), click **Import** or **Publish**.
2. Gym Art Meets creates all the gymnasts in your club roster.
3. You'll see a confirmation with how many were added.

## Common stumbling blocks

The top three issues people hit: wrong date format, misspelled level names, and missing required fields. The [fix CSV import errors](/club-management/fix-csv-import-errors.md) page walks through each one.

Any columns beyond the standard seven are treated as custom fields automatically.

## What's next

* [Register for a meet](/registration/index.md) - Get your gymnasts into a competition
* [Upload floor music](/music/upload-music.md) - Add music files for your roster

## Related

* [CSV template and format](/club-management/csv-template-and-format.md) - Column details, delimiters, and date format options
* [Fix CSV import errors](/club-management/fix-csv-import-errors.md) - Solutions for common problems
* [Advanced import settings](/club-management/advanced-import-settings.md) - Encoding, line endings, and other tweaks
* [Club management overview](/club-management/index.md)


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.gymart.org/club-management/import-gymnasts-csv.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
