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

# Coupons & Discounts

> Discount codes, volume pricing and pop-up offers on your Komerza store

Komerza gives you three independent ways to discount: **coupon codes** that customers enter at checkout, **volume discounts** that apply automatically as quantity increases, and **pop-up offers** shown on the storefront. They can be combined, and there is one control for stopping them from stacking.

## Coupon codes

Coupons are managed under **Products → Coupons**.

| Field                   | Rules                                                                                |
| ----------------------- | ------------------------------------------------------------------------------------ |
| **Code**                | 3-32 characters, case-insensitive, unique per store                                  |
| **Type**                | Percentage (0-100%) or fixed amount (up to 100,000, never more than the order total) |
| **Maximum uses**        | Optional - the coupon auto-disables when the cap is reached                          |
| **Expiration date**     | Optional                                                                             |
| **Variant restriction** | Optional - restrict the code to specific variants                                    |

Coupon capacity depends on your plan: **Free** 5, **Premium** 1,000, **Business** unlimited.

### What customers see when a code fails

<ResponseField name="Please enter a valid coupon code.">
  The code does not exist, or has been disabled.
</ResponseField>

<ResponseField name="Coupon cannot be applied to this order.">
  The code exists but is expired, fully used, or restricted to variants that are
  not in the cart.
</ResponseField>

<Note>
  A coupon's usage count increments when the order is **delivered**, not when it
  is paid - so the count can look low while orders are still in flight.
</Note>

## Volume discounts

Volume discounts are quantity tiers set per variant, on the variant card. Each tier has a quantity threshold and one of three types:

<ResponseField name="Percentage">
  A percentage off, shown on order pages as e.g. "10% off".
</ResponseField>

<ResponseField name="FixedAmount">
  An amount off per unit, shown in your store currency, e.g. "5.00 off total".
</ResponseField>

<ResponseField name="FixedPrice">
  A new unit price, shown in your store currency, e.g. "8.00 each".
</ResponseField>

Each quantity can carry only one tier - duplicates are rejected with "A volume discount tier for quantity N already exists."

<Tip>
  Volume discounts pair well with variants that have a **maximum quantity** set
  generously. If your variant caps quantity at 1, tiers above 1 can never be
  reached.
</Tip>

## Stopping discounts from stacking

Each variant has a **Disable volume discount on coupon** toggle. When enabled, volume pricing is dropped if the customer applies a coupon code, so the two discounts never combine on the same line item.

Decide this per variant based on your margin - the default is that both can apply.

## Pop-up offers

**Products → Pop-up Offers** manages storefront discount dialogs. These are shown to visitors on your storefront and are configured separately from coupon codes.

## Affiliate discounts

Affiliate discounts are a fourth, separate mechanism: they are configured per product on the product editor's **Affiliate** tab, where you can use your store's default affiliate discount, set a custom percentage, or turn it off for that product. They apply when a customer arrives through an affiliate link rather than by entering a code.

## Applying discounts in bulk

The Products list supports bulk updates, including the **affiliate discount** across many products at once. Coupon codes themselves are store-wide by default, so a single code is usually simpler than editing many products.

## Next steps

<CardGroup cols={2}>
  <Card title="Products & Variants" icon="box" href="/guides/products-and-variants">
    Pricing, quantity limits and stock modes.
  </Card>

  <Card title="Managing Orders" icon="receipt" href="/guides/orders">
    See which coupons were used on an order.
  </Card>

  <Card title="Coupons API" icon="code" href="/api-reference/endpoint/coupons/create">
    Create and manage coupons programmatically.
  </Card>

  <Card title="Affiliates API" icon="handshake" href="/api-reference/endpoint/affiliates/configure">
    Configure affiliate commission and discounts.
  </Card>
</CardGroup>