> ## Documentation Index
> Fetch the complete documentation index at: https://help.simpletix.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Managing Promo Codes in SimpleTix

> Create and manage promo codes, configure an optional checkout popup, and track discount usage in SimpleTix.

## Overview

[Give Buyers a Discount and Track Partner Sales](https://www.loom.com/embed/9c230458a285419d99f75838505480a8?captions=true)

Promo codes can be:

* **Single Use** (one code for many customers or unique code for each buyer),
* **Bulk Generated** (hundreds or thousands of random codes),
* **Imported** (via CSV),
* **Exported** (for record-keeping or analysis).

Each code can be tied to a specific event or ticket type, with configurable redemption limits, expiration dates, and discount styles (percentage or flat rate).

***

## Creating Promo Codes

### Creating a Single Promo Code

1. **Navigate to the Global Promo Codes Page**

   * Log in to the [Manager Portal](https://manager.simpletix.com).
   * Click **Marketing** in the top rail and then select Promo Codes.
   * Alternatively, go to [manager.simpletix.com/promote/promocode](https://manager.simpletix.com/promote/promocode).

   **Navigate to an Event-Specific Promo Codes Center**

   * Log in to the [Manager Portal](https://manager.simpletix.com).
   * Select your event from **Events** then click **Promo Code** (left-hand menu).
2. **Create New Code**
   * Click **Create Promo Code**.
   * Provide a promo code name (for example, “FALLSALE20”).
   * Set optional parameters:
     * **Category** (to organize and view codes later),
     * **Redemption limits** (number of times the code can be used),
     * **Active period** (start/expiration date).
   * Click **Next** (or **Continue**).
3. **Configure Discount Details**
   * **Discount Type**: Choose **percentage** or **flat amount**.
   * **Eligible Tickets**: Select which tickets (or event times) the code applies to.
   * **Save** to finalize.

### Promo Codes for Membership Purchases

To discount a membership purchase, create or edit a code from the global **Promo Codes** page. In the section that controls where the code is valid, choose **Valid on all memberships**, set the discount and redemption limits, then save.

This option appears when your account has a membership and membership discounts are enabled. If it is missing, contact SimpleTix Support for help. It applies to membership purchases; to discount event tickets, choose the appropriate event or ticket eligibility instead.

### Managing Promo Code Categories

Categories help you organize your promo codes. You can:

* **Rename a category**: Click the category name to edit its title.
* **Delete a category**: Remove categories you no longer need. Codes within a deleted category will become uncategorized but are not deleted.

> **Note**: On an event's promo code page, you can get a link to your event page that applies a promo code automatically. Click the promo code you want, then copy the "Discount Link".

***

### Bulk Creating Promo Codes

Bulk code generation is available at both the **event level** and the **site level** (global promo codes page).

1. **Generate Multiple Codes**
   * From your event’s **Promo Codes** page or the global [Promo Codes](https://manager.simpletix.com/promote/promocode) page, click **More** → **Generate Bulk Codes**.
   * Indicate how many codes to create (for example, 100 unique codes).
   * **Use a template:** Select an existing promo code to copy its settings into the new codes.
2. **Set Code Parameters**
   * **Uses per Code** (for example, unlimited, limited by number of orders, or limited by number of tickets).
   * **Tickets per Order Limit** (optional).
   * **Discount Type** (flat or percentage) and **Expiration** settings.
3. **Confirm & Download**
   * Click **Create Promo Code**.
   * Download or view the newly generated codes.

***

## Showing a Promo Code Popup at Checkout

The optional **Promo Code Popup** asks buyers for a code when they open ticket selection or arrive at checkout. Configure it separately for each event. It is off by default, and buyers can close it to continue without entering a code.

### Enable the Popup

1. In the Manager Portal, open **Events** and select your event.
2. Select **Event Details** in the left-hand menu.
3. Find the **Promo Code Popup** card, below **Checkout & Ticket Settings**.
4. Turn on **Show promo code popup**.
5. Under **Show on**, choose one placement:
   * **Ticket selection**: Ask when the buyer opens the ticket selection screen. This is the default.
   * **Checkout page**: Ask when the buyer arrives at checkout, before entering contact and payment details.
6. Enter a **Header**, such as “Do you have a promo code?” Add optional instructions in **Subtext**.
7. Configure the remaining options below, then click **Save**.

Create or import your promo codes before enabling the popup. The popup uses your existing codes and their event, ticket, date, and redemption rules; it does not create discounts on its own.

### Customize the Text

| Setting | What buyers see | Character limit |
| - | - | - |
| **Header** | The required heading at the top of the popup. | 60 |
| **Subtext** | Optional instructions below the heading. | 160 |
| **Promo code placeholder** | A hint inside the entry field. Leave blank to use “Enter promo code.” | 50 |
| **Success message** | An optional confirmation after a valid code is applied, followed by a **Continue** button. Leave blank to close the popup immediately after applying the code. | 80 |
| **Failure message** | Optional text shown when a code cannot be applied. Its behavior depends on **Show promo code errors**, described below. | 80 |

### Choose What Happens When a Code Does Not Apply

**Show promo code errors** is off by default.

| Show promo code errors | Failure message | Buyer experience |
| - | - | - |
| **Off** | Blank | The popup closes without an error, and checkout continues without the discount. |
| **Off** | Filled in | The custom message appears with a **Continue** button. Buyers cannot retry within the popup. |
| **On** | Blank | The standard error appears below the entry field, and buyers can try another code. |
| **On** | Filled in | The custom message appears below the entry field, and buyers can try another code. |

For a typical discount promotion, turn **Show promo code errors** on so buyers can correct a mistyped code.

### Also Fill In a Checkout Field

Use **Also fill in** to copy the submitted value into another checkout field:

* **None**: Do not copy the value anywhere else. This is the default.
* **Billing ZIP / postal code**: Copy it into the billing postal code field.
* **Organization name**: Copy it into the organization field.
* **Attendee question**: Choose an existing Single Line, Multi Line, or Number question for the event.

The destination field or question must be displayed directly on checkout. Only empty fields are filled, and buyers can edit the value afterward. For a question asked for each ticket, the value fills each empty answer. The value can be copied even if the code does not qualify for a discount; closing the popup without submitting copies nothing.

**Example: Local resident pricing**

Create or import eligible ZIP codes as promo codes with the desired discount. Set the header to “What is your ZIP code?”, add instructions in **Subtext**, and choose **Billing ZIP / postal code** under **Also fill in**. A matching code applies its configured discount, while the entered ZIP can also fill the empty billing postal code field. The discount comes from the promo code match; it is not automatically determined from the buyer's payment details.

### What Buyers See

* Buyers enter a code and select **Apply**. When the code applies, eligible prices or sales tax update according to the code's settings.
* Buyers can select the **×** to close the popup and continue without entering a code. The normal promo code entry remains available in the cart.
* The popup is skipped when a promo code or membership discount is already applied, including a code applied through a discount link.
* The popup supports desktop and mobile online checkout, including embedded checkout. It is not shown in Box Office, season-pass checkout, or Square catalog/special-offer checkout flows.

Before sharing the event, check the selected placement and your messages using a valid code and a code that does not qualify. If you use **Also fill in**, confirm that the destination field is visible and receives the submitted value.

***

## Managing & Reporting

### Bulk Editing & Deleting Codes

You can mass-select promo codes to delete them in bulk:

1. From the **Promo Codes** page (event-level or global), select multiple codes using the checkboxes.
2. Use the bulk action options to delete the selected codes.

This is especially useful for cleaning up expired or unused codes after a promotion ends.

***

### Viewing & Filtering Codes

1. **Event-Specific View**
   * From **Events**, select your event, then go to **Promo Codes**.
   * This displays all codes tied to that event, including redemption stats and discount links.
2. **Global Promo Code View**
   * Visit [manager.simpletix.com/promote/promocode](https://manager.simpletix.com/promote/promocode) **without** selecting an event.
   * All codes across all events are displayed (useful for multi-event management).

> **Tip**: Use the search/filter tools to locate specific codes or categories.

***

### Exporting Codes

* While on the **Promo Codes** page, click **More** → **Export List**.
* A `.csv` file with all current codes (and basic info like redemption counts) is generated — ideal for offline analysis.

***

### Importing Codes

1. **Download CSV Template**
   * From **Promo Codes**, click **More** → **Import List** → **Download Template**.
2. **Fill in Code Data**
   * Each code belongs on its own row.
   * Maintain the `.csv` format (avoid `.xlsx`).
3. **Upload & Finalize**
   * Drag the completed file into the pop-up or navigate to it.
   * Confirm additional settings (usage limits, discount type, etc.).
   * **Import** to add these codes to your event.

***

### Tracking Usage & Reporting

1. **Unique Discount Links**
   * Each code has its own discount URL.
   * Share these with affiliates/influencers to track sales attributable to them.
   * For more robust affiliate tracking, consider using the [Affiliate Marketing Center](https://help.simpletix.com/docs/marketing/affiliate-marketing-center.md) which provides detailed attribution reports and QR codes.
2. **Usage Reports**
   * Click a promo code in the **Promo Codes** list to view:
     * **Number of redemptions** and **remaining uses**.
     * **Associated orders**: which customers used it, how many tickets were discounted, etc.
3. **Order Details**
   * Within each order, SimpleTix lists any applied promo code.
   * Cross-reference code usage in standard attendee or sales reports for deeper analytics.

***

## Frequently Asked Questions (FAQ)

**Q1: Can I apply a code to all my “fall concerts” at once?**

* **A:** Currently, promo codes apply only to **specific events** or **ticket types**. You can’t target an entire “event category” en masse.

**Q2: Where do I see which orders used a particular code?**

* **A:** Click the code in the Promo Codes page. The details view shows all orders linked to that code.

**Q3: Why can’t I find the Bulk Create or Import options?**

* **A:** Bulk code generation is available on both the **event-specific Promo Codes** page and the **global Promo Codes** page. Click **More** to find the option. If still missing, contact [SimpleTix Support](mailto:support@simpletix.com) or check if your user role is restricted.

**Q4: How do I share a code so it applies automatically at checkout?**

* **A:** Copy the **unique discount link** from the code’s detail page and send it to your customers. That link pre-fills the code at checkout.

**Q5: Can I limit the discount to, say, only 2 tickets per order?**

* **A:** Yes. When creating or editing the promo code, set the **Tickets per Order** limit accordingly.

**Q6: Can I ask buyers for a promo code automatically?**

* **A:** Yes. Enable **Show promo code popup** under your event's **Event Details → Promo Code Popup** card. Choose ticket selection or the checkout page as its placement. Buyers can dismiss it and continue without a code. See [Showing a Promo Code Popup at Checkout](#showing-a-promo-code-popup-at-checkout) for setup and message options.

***

## Conclusion

When you create codes, either single or in bulk, you define discount parameters and event/ticket applicability. Then, use the management features to import/export codes, monitor usage, and generate unique links for affiliates or influencers. SimpleTix’s dashboard centralizes your promo code operations, making it easy to track redemptions and performance across all events. If you need further assistance or advanced configurations, please reach out to [SimpleTix Support](mailto:support@simpletix.com).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.