Import promo codes from a CSV¶

Create many promo codes at once by uploading a spreadsheet of codes. Every code in the file gets the same discount and applies to the same events, checkouts, or products.

Quick steps¶

1. Put your codes in one column of a spreadsheet and save it as a CSV file.
2. In the host dashboard, go to Promo Codes and click Import codes.
3. Upload your CSV file and click Next.
4. Map your codes column to Code.
5. Set the discount type and amount.
6. Choose what the codes apply to.
7. Set a usage limit and an active timeframe if you need them.
8. Click Finish import.

When the import finishes, your new codes appear in the promo codes table. A message at the top of the page confirms the import. If any codes weren't imported, the message lists them and stays until you close it.

Step-by-step walkthrough¶

1. Prepare your CSV file¶

1. In Excel, Google Sheets, or Numbers, put one promo code per row in a single column.
2. You can add a header in the first row (for example, Code). It is skipped by default.
3. Save or export the file as CSV.

2. Open the importer¶

1. In the host dashboard, go to Promo Codes.
2. Click Import codes.

3. Upload your file¶

1. Drag your CSV file into the upload area, or click to choose it.
2. Click Next.

4. Map your codes column¶

1. Above each column from your file, choose what the column holds.
2. Set your codes column to Code.
3. If your file has other columns, delete them with the trash icon. Only the code is imported.
4. If your file has no header row, click the info icon on the first row so that row is imported as a code too.

Empty cells and codes that appear more than once in your file are highlighted in red. Fix or delete those rows before you continue.

5. Set the discount¶

1. Choose Percentage or Fixed Amount.
2. Enter the discount. Percentages must be between 0 and 100.

6. Choose what the codes apply to¶

In Apply Code To, pick one:

• All Products & Checkouts: the codes work everywhere.
• Specific Products / Checkouts: pick the events, checkouts, or products the codes work on.
• All Except Selected: the codes work everywhere except what you exclude.

7. Set usage limits and a timeframe (optional)¶

1. Under Usage Limits, choose how uses are counted:
   • Product Usage: each product the code is applied to counts as one use.
   • Order Usage: each order the code is used on counts as one use.
2. Enter the maximum number of uses, or leave it empty for unlimited.
3. To limit when the codes work, check Set active timeframe and pick a start and end date. Codes start at 12:00 AM on the start date and stop at 11:59 PM on the end date, in your local time.

The limit applies to each code on its own. For example, Order Usage with a limit of 1 gives you single-use codes: each code works for one order.

8. Finish the import¶

1. Click Finish import. If the button shows a message instead, fix what it describes first.
2. Keep the page open while the codes are created. The progress shows next to Map Columns.
3. When it finishes, check the message at the top of the Promo Codes page.

Every imported code starts as active. To change a single code later, open it from the table and edit it.

Troubleshooting¶