---
title: Bulk import boxers
contentType: How-to
description: Import many boxers at once with an Excel or CSV file, review and fix entries, and handle duplicates.
date: 2026-09-03
tags: clubs, boxers, import
sort_order: 4
slug: clubs/bulk-import-boxers
---

# Bulk import boxers

This guide shows how to import many boxers at once from an Excel or CSV file. You prepare a file with the correct columns, import it, review and fix the entries in an editable table, and submit.

## Prerequisites

- Admin or licensing permissions for your club
- A boxer file in the correct format, described below

## 1. Open the bulk import

1. Go to your club's **Boxers** page.
2. Click the three-dots menu icon (⋮) in the top right corner.
3. Choose **Bulk add**.

## 2. Prepare your data

Create an Excel (`.xlsx`, `.xls`) or CSV file with these columns, in this exact order:

| Column            | Required | Format         | Example    |
| ----------------- | -------- | -------------- | ---------- |
| First name        | Yes      | Text           | John       |
| Last name         | Yes      | Text           | Smith      |
| Date of birth     | Yes      | YYYY-MM-DD     | 1995-03-15 |
| Gender            | Yes      | male or female | male       |
| Weight            | Yes      | Number (kg)    | 75.5       |
| Number of matches | Yes      | Number         | 12         |

Format notes:

- The first row should contain column headers.
- All fields are required.
- Dates must be in YYYY-MM-DD format.
- Weights are rounded automatically to the nearest whole number.
- Gender must be exactly `male` or `female`, lowercase.

Example template:

```csv
First name,Last name,Date of birth,Gender,Weight,Number of matches
John,Smith,1995-03-15,male,75,12
Jane,Doe,1998-07-22,female,60,8
Mike,Johnson,2000-11-05,male,82,15
```

## 3. Import the file

1. In the bulk import dialog, click **Choose File**.
2. Select your Excel or CSV file.

The file is parsed and all boxers appear in an editable table. Invalid entries are highlighted in red, and possible duplicates are highlighted in yellow.

## 4. Review and edit

In the table you can:

- **Edit any field** by clicking it.
- **Add rows manually** with the **+ Add** button.
- **Delete rows** with the trash icon on each row.
- **See validation errors**: invalid rows are highlighted in red.
- **See duplicate warnings**: possible duplicates are highlighted in yellow with a warning icon.

### Duplicates

Duplicates are detected by matching first name, last name, gender, and date of birth. When duplicates are found:

- A warning count appears at the top: "Warning: X duplicates".
- Duplicate rows are highlighted in yellow.
- Hover over the warning icon (△) for details.

You can proceed anyway, or remove the duplicates first.

## 5. Submit

1. Check the counter showing valid entries: "Add X/Y boxers", where X is the number of valid entries and Y is the total number of rows.
2. Click **Add X/Y boxers**.
3. If duplicates exist, confirm in the dialog.

Valid boxers are created, a success message appears, and the boxer list refreshes with the new entries.

## Troubleshooting

### Invalid entries are not accepted

Check that every required field is filled:

- First and last name are not empty
- Date of birth is valid, in YYYY-MM-DD format
- Gender is exactly `male` or `female`
- Weight and number of matches are valid numbers

### Weights differ from what I entered

This is expected. Weights are rounded to the nearest whole number, so 75.5 becomes 76.

### Duplicate warnings for different boxers

Duplicates are detected by name, gender, and date of birth. Two boxers with identical values in those fields are flagged, even if they are different people. Confirm the duplicates to proceed.

### File does not upload

- Confirm the file is `.xlsx`, `.xls`, or `.csv`.
- Check the column structure against the table above.
- Try a smaller file first to test the format.
- Check your browser console for errors.

## Tips

- Start with a small test file of 5 to 10 boxers to verify your format.
- Export existing boxers first and use the result as a template.
- Keep a backup of your import file in case you need corrections.
- Empty rows in the spreadsheet are skipped automatically.