# Importing competitions

Category: [Competitions & Draws](https://basecomp.io/help/competitions)
Updated: 2026-10-30

> Upload a CSV under Competitions > Import Competitions to create or update many competitions at once. Title, price, tickets and end date are required.

You can create or update many competitions at once from a CSV file under [Competitions > Import Competitions](https://basecomp.io/dashboard/go/raffles/import) (or the **Import** button on [Competitions > Manage](https://basecomp.io/dashboard/go/raffles)). Each row needs a title, ticket price, total tickets and end date; you map your columns to Basecomp's fields, choose whether to create, update or both, and the import reports what it did row by row.

Don't see **Import Competitions** in your sidebar? Add the **Import** app from [Apps](https://basecomp.io/dashboard/go/apps). See [Adding and removing apps](https://basecomp.io/help/getting-started/adding-and-removing-apps).

### Preparing the file

Click **Download CSV template** for an example to start from. Your CSV must have headers in the first row. Fields you can import:

- **Title** (required)

- **Ticket Price** (required), in pounds and pence, for example 1.99

- **Total Tickets** (required)

- **End Date** (required), for example 2026-12-01 20:00

- **Description** and **Summary (short description)**

- **Status**: draft, scheduled, published (also "active" or "live"), completed or cancelled. Blank or unrecognised values import as draft.

- **Categories**: separate several with a semicolon, for example Featured;Summer

- **Prize Names**: the first name becomes the main prize. It must match a prize already in your **Prize Catalogue** exactly.

- **Competition ID (for updates)**: to match existing competitions by ID

Test with a small batch first before importing everything.

### Running the import

- Go to **Competitions > Import Competitions** and choose your file under **Select CSV file**.

- In **Import settings**, choose **What do you want to do?**: **Import all competitions**: update matches and create the rest.

- **Only update existing competitions**: rows with no match are skipped.

- **Only create new competitions**: existing competitions are skipped and nothing is changed.

- Unless you are only creating, choose **Match competitions by**: **Competition Title** or **Competition ID**.

- Leave **Create categories that don't exist yet** on to have new category names created for you, or turn it off to ignore unknown ones.

- Under **Map CSV columns**, check the mapping. Basecomp auto-detects common column names; anything highlighted needs to be mapped or skipped. The **How your import will work** box sums up what will happen.

- Click **Start import**.

[Image: The Import Competitions page with the Choose file button, CSV tips and the Download CSV template button]

**Import progress** then shows how many rows were **Processed**, **Created**, **Updated** and **Failed**, and **Row errors** lists the reason for each failed row.

Take care when updating: Description, Summary, Categories and the main prize are replaced by what the file says. A blank cell, or a column left out of the mapping, clears them, and an empty Prize Names removes the main prize from a competition that is not yet locked. Include those columns, filled in, whenever you update existing competitions.

### What an import does not set

The CSV has no columns for instant wins, a growing jackpot, the draw setting, the per-customer limit, bundle deals, the page layout or images. On an update these are kept as they are. A new competition starts with the defaults: no instant wins, an automatic draw and no bundle deal. Add images and any of the rest on the competition's page afterwards.

### Importing live competitions

An import goes through the same save as the competition editor, so the same rules apply. A row cannot change the price, tickets or prize of a competition that is already published on a live store, and a row that tries an illegal status change fails with the reason in **Row errors**.

The safest approach is to import new competitions as **draft**, check each one on its page, and publish from there, where you get the full publish checks and confirmation.

### See also

- [Creating a competition](https://basecomp.io/help/competitions/creating-a-competition)

- [Importing prizes](https://basecomp.io/help/prizes-and-winners/importing-prizes)

- [Moving to Basecomp from another platform](https://basecomp.io/help/getting-started/moving-to-basecomp-from-another-platform)

- [Competition categories and the calendar](https://basecomp.io/help/competitions/competition-categories-and-calendar)
