Skip to main content

Bulk Updating Promo Codes

Updated

Overview

↑ Back to top

TUNE's bulk promo code tools let you import and remove large volumes of promo codes without adding them one by one. You can upload up to 10,000 codes at a time via a CSV file and assign each code to a partner in the same operation. You can also delete up to 500 codes at a time using the bulk actions option in the Promo Codes table.

These tools are designed for advertisers onboarding to TUNE with an existing promo code inventory, as well as established programs that need to rotate or retire codes across a large partner base.

Availability

↑ Back to top

Bulk promo code management is only available in the new offer experience. If you are using the classic offer view, switch to the new experience to access these features. Bulk actions are included in all TUNE pricing tiers at no additional cost.
 

Bulk Upload via CSV

↑ Back to top

The Import Promo Codes tool lets you upload a CSV containing your promo codes and the partner each code should be assigned to. You can match codes to partners by partner ID or by partner email address.

  1. Navigate to the offer you want to manage and click the Promo Codes tab. image-20250805-135556.png
  2. Click Import Promo Codes. The import modal will open.image-20250805-135749.png
  3. Download the CSV template that matches how you want to identify partners — Partner ID Based or Email Based. Use whichever matches the data you have on hand.
  4. Populate the CSV with your promo codes and partner identifiers. See CSV Format Requirements below for column names and formatting rules.
  5. Drag your completed CSV into the upload area, or click to browse and select the file from your computer.
  6. Click Import Promo Codes. You will immediately see a success message confirming the file was received. image-20250805-135947.png
The import runs in the background after you submit. You do not need to keep the modal open. TUNE will send you a notification when the process is complete — see Import Notifications and Errors for details.
 

CSV Format Requirements

↑ Back to top

Your CSV must include a code column plus at least one partner identifier column. The valid columns are:

Column Required Description
code Always The promo code string to import
affiliate_id Required if not using email The numeric TUNE partner ID to assign the code to
affiliate_email_address Required if not using partner ID The email address associated with the partner account

Include either affiliate_id or affiliate_email_address — not both in the same file. If the file contains any column names outside of these three, the entire import will be rejected.

Example — Partner ID based

code,affiliate_id
SPRING25,10042
SUMMER25,10099
WELCOME10,10042

Example — Email based

code,affiliate_email_address
SPRING25,partner@example.com
SUMMER25,another@example.com
Column names are case-sensitive and must match exactly. If the import notification shows "Invalid columns. Valid columns are: code, affiliate_id, affiliate_email_address" it means one or more column headers in your file don't match. Check for extra spaces, different capitalisation, or additional columns and re-upload.
 

Import Notifications and Errors

↑ Back to top

image-20250805-140851.png

Once the import completes, TUNE sends a notification to your account. You can view notifications by clicking the bell icon in the top navigation, or by going to Notifications from the main menu.

image-20250805-140805.png

Common import outcomes

Notification message What it means What to do
Import complete — X codes imported successfully All rows processed without errors No action needed. Codes are now visible in the Promo Codes tab.
No Offer Promo Codes were imported The entire file was rejected, typically due to invalid column names Check your CSV column headers match exactly: code, affiliate_id, affiliate_email_address
X codes imported, Y rows failed Some rows were imported successfully; others had row-level errors Review the error detail in the notification. Common causes: partner ID not found, code already exists for that offer, or a blank value in a required column.

Bulk Delete

↑ Back to top

You can delete up to 500 promo codes at a time directly from the Promo Codes table. This is useful when rotating out stale codes or clearing space before a new import — TUNE enforces a 10,000-code limit per offer.

  1. Go to the Promo Codes tab for the offer.
  2. Use the checkboxes to select the codes you want to remove. You can use the header checkbox to select all visible rows, or select individual codes. The search bar can help you filter codes before selecting.
  3. Once codes are selected, click Disable to remove them.bulk-delete.gif
Bulk delete is limited to 500 codes per action. If you need to remove more than 500 codes, repeat the process in batches. Deleted codes cannot be recovered — confirm your selection before proceeding.
 

Tips and Limits

↑ Back to top

Maximum 10,000 codes per offer. If you are approaching this limit, use bulk delete to remove stale codes before importing new ones. The Promo Codes tab shows your current count.
 
Maximum 10,000 codes per import file. If you have more than 10,000 codes to load, split your CSV into multiple files and run sequential imports.
 
Use the CSV templates provided in the modal. Downloading and populating the template rather than building your own file is the easiest way to avoid column header errors.
 
Duplicate codes are rejected at the row level. If a promo code already exists on the offer for the same partner, that row will fail, but the rest of the file will still process. Check the import notification for row-level error details.
 
Bulk actions are only available in the new offer experience. If you don't see the Import Promo Codes button or bulk checkboxes, confirm you are not in the classic offer view.
 

Need Help?

↑ Back to top

If your import isn't completing, codes aren't appearing after a successful notification, or you're running into errors you can't resolve, contact the TUNE Support team. When reaching out, include:

  • The offer ID you were importing codes to
  • A copy of the CSV file you uploaded (or a few sample rows)
  • The full text of the import notification, including any error messages
  • The date and approximate time of the import attempt

Related articles