> ## Documentation Index
> Fetch the complete documentation index at: https://docs.9pic.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Checkout Coupons

> Create discount codes, bulk-generate coupons, and control when they apply.

<Warning>
  9Pic Checkout is a **Beta**, **Enterprise plan** feature. Coupons only work once checkout is live with at least one published package.
</Warning>

## Overview

The **Coupons** tab lets you create discount codes buyers enter at checkout. Search existing codes, activate or deactivate them in bulk, and export codes to CSV.

<Note>
  If no package is published yet, a notice reminds you that coupons take effect only after buyers can check out.
</Note>

## Create a coupon

Click **New coupon** and choose:

| Option            | Use when                                                        |
| ----------------- | --------------------------------------------------------------- |
| **Single coupon** | You want one specific code with custom settings                 |
| **Bulk create**   | You need many unique codes at once (for example, a promo batch) |

### Single coupon fields

The coupon builder groups settings into sections:

**Discount basics**

| Field             | Options                                                        |
| ----------------- | -------------------------------------------------------------- |
| **Code**          | The text buyers type at checkout                               |
| **Discount type** | **Percentage off** or **Flat amount off**                      |
| **Value**         | Percentage or fixed amount in a currency used by your packages |

**Redemption limits**

| Field               | Purpose                                            |
| ------------------- | -------------------------------------------------- |
| **Once per buyer**  | Each buyer can use the code only once              |
| **Max redemptions** | Total times the code can be used across all buyers |

**Targeting**

| Field          | Options                                                  |
| -------------- | -------------------------------------------------------- |
| **Sale phase** | **Any time**, **Pre-event only**, or **Post-event only** |
| **Active**     | Whether the code is live immediately                     |

**Advanced (optional)**

| Field                    | Purpose                                                    |
| ------------------------ | ---------------------------------------------------------- |
| **Package restriction**  | Limit the code to one specific package                     |
| **Validity window**      | Start and end dates                                        |
| **Minimum order amount** | Order must meet this threshold before the discount applies |
| **Note**                 | Internal label for your team                               |

### Bulk create

Bulk creation generates many unique codes with shared settings (discount type, sale phase, limits, etc.). After creation, use **Download CSV** to retrieve the generated codes.

## Manage coupons

### Search and filter

* **Search** — match by code or internal note
* **State filter** — All, Active, Inactive, or Archived

### Coupon states

| State        | Meaning                                 |
| ------------ | --------------------------------------- |
| **Active**   | Buyers can redeem the code              |
| **Inactive** | Code exists but cannot be used          |
| **Archived** | Retired; removed from active management |

### Bulk actions

Select coupons with the row checkboxes, then stage **Activate** or **Deactivate** for the selection. Click **Save changes** to apply staged status updates. The page blocks navigation while unsaved coupon status changes are pending.

Individual coupons can also be edited or archived from the row actions menu.

### Export

**Download CSV** exports the current filtered coupon list for spreadsheets or external distribution.

## Common Questions

<AccordionGroup>
  <Accordion title="Can a coupon apply to only one package?">
    Yes. Use the optional package restriction in the coupon builder, or create a coupon directly from a package editor with the package pre-selected.
  </Accordion>

  <Accordion title="Which currencies can flat-amount coupons use?">
    Flat discounts use currencies already present in your event's packages — not the full gateway currency list.
  </Accordion>

  <Accordion title="What is the difference between inactive and archived?">
    Inactive codes can be reactivated quickly. Archived codes are retired from day-to-day use but kept for records.
  </Accordion>
</AccordionGroup>

## Next Steps

<CardGroup cols={2}>
  <Card title="Packages" icon="box" href="/dashboard-guide/checkout/packages">
    Publish packages before coupons can be redeemed.
  </Card>

  <Card title="Checkout Configuration" icon="gear" href="/dashboard-guide/checkout/configuration">
    Enable checkout when setup is complete.
  </Card>

  <Card title="Transactions" icon="receipt" href="/dashboard-guide/checkout/transactions">
    Review completed orders after promotions run.
  </Card>
</CardGroup>