# Coupons

Coupons allow you to create discount codes for your Tebex store, offering a powerful way to incentivize purchases, promote campaigns, or reward loyal customers. You can create fixed or percentage-based discounts, target specific products or categories, and control usage limits.

***

### Creating a Coupon

To create a new coupon:

1. In your Control Panel, go to **Engagement > Coupons**.
2. Click **Create Your First Coupon** or **Create Coupon**.
3. Complete the following fields:

#### Coupon Details

* **Code**: Enter your desired code or click **Generate Code** for a random one.
* **Effective On**: Choose to apply the coupon to:
  * All products
  * Specific packages
  * Specific categories
* **Discount Type**:
  * *Percentage*: Set a value (e.g. 10%)
  * *Fixed Amount*: Set a currency value (e.g. $5)

#### Duration

* **Start Date**: When the coupon becomes valid.
* **Expiry Date**: When the coupon expires. You can check **Never** to keep it active indefinitely.

#### Usage Rules

* **Redeem Limit** *(optional)*: Max total redemptions across all users.
* **Redeem Limit Per Customer/IP** *(optional)*: Limits usage per individual customer or IP.
* **Minimum Basket Value** *(optional)*: Sets a threshold before the coupon can be used.
* **Username Restriction** *(optional)*: Restricts coupon usage to a specific username.
* **Note** *(optional)*: Internal-only note for tracking purposes.

***

### Coupon Application Rules Explained

This setting determines how the coupon interacts with other discounts or sales. Here's how each rule works:

#### 1. **Apply to each qualifying package individually**

Discount is applied separately to each eligible item.

Example:

* Package A: $5 → $4.50 (10% off)
* Package B: $10 → $9.00 (10% off)\
  **Total: $13.50**

***

#### 2. **Apply to basket containing qualifying packages *****before***** sales**

Coupon applies first, followed by any store-wide sales.

Example with 10% coupon and 20% sale:

* $15 basket → $13.50 (10% off)
* $13.50 → $10.80 (20% off)\
  **Total: $10.80**

***

#### 3. **Apply to basket containing qualifying packages *****after***** sales**

Store-wide sales apply first, then the coupon.

Same example:

* $15 basket → $12.00 (20% off)
* $12.00 → $10.80 (10% off)\
  **Total: $10.80**

*While the result may appear the same in percentage examples, fixed amount discounts and minimum basket rules can lead to differences.*

***

### Managing Coupon Settings

By default, customers will be able to use an unlimited number of coupons on their basket.

#### Change the Max Coupons Per Basket

1. Go to **Engagement > Coupons**.
2. Click **Settings** (top-right).
3. Adjust the **Max Coupons Per Basket** setting.

***

### Advanced Options

You can also manage coupons through the [Tebex Plugin API,](https://docs.tebex.io/plugin/endpoints/coupons) ideal for automation or integrations.

***

### Best Practices

* Use short, memorable codes for marketing (e.g. `SUMMER10`).
* Set redemption limits to avoid misuse.
* Combine coupons with time-limited sales for greater urgency.

### **Academy Video Guide**

Check out our video tutorial on Sales, Coupons & Gift Cards.

{% embed url="<https://www.youtube.com/watch?v=AaL2ara4Zac>" %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.tebex.io/creators/tebex-control-panel/engagement/coupon-codes.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.