> ## Documentation Index
> Fetch the complete documentation index at: https://docs.gameball.co/llms.txt
> Use this file to discover all available pages before exploring further.
# How Do I Create a Coupon Manually with Gameball?
> Easily create customized coupons tailored to your marketing strategies and customer needs directly through the Gameball Dashboard.
| Platform | Plan |
| --------- | ------------------------------------------------------ |
| Selfserve | Add-on ([Contact Support](mailto:support@gameball.co)) |
With Gameball's couponing engine, you can manually create unique coupons to reward your customers or drive specific business objectives. This article walks you through accessing the coupon creation feature and setting up a coupon manually.
***
## Accessing the Coupon Creation Feature
Log in to your **Gameball Dashboard**.
From the left-side menu, navigate to **Coupons**.
Click on the **Create Coupon** button at the top of the page.
***
## How to Create a New Coupon
Define the type of coupon you want to create:
* **Free Product**
* **Free Shipping**
* **Fixed Amount-Based Discount** (e.g., \$10 off)
* **Percentage Amount-Based Discount** (e.g., 15% off)
* **Buy X Get Y** (for automatically applied coupons only)
* **Percentage-Based Cashback**
* **Fixed Amount-Based Cashback**
* **Percentage Amount-Based Fees Discount**
1. **Set how the coupon will be applied:** Choose between Discount Code or Automatic.
* **Discount Code:** A code shared with customers to use at checkout.
* **Automatic:** A discount applied automatically once the customer qualifies.
2. **Internal Name:** Provide a unique name for your coupon for better monitoring on the dashboard.
3. **Coupon Code:** Manually enter a code or allow Gameball to auto-generate it.
4. **External Name:** Customers see the **localized display name** in their widget, emails, and web messages.
5. **Terms & Conditions:** Add localized Terms & Conditions for manual coupons to clearly communicate coupon rules and usage limits in each customer's preferred language.
6. **Coupon Value:** Enter the value based on the type chosen.
7. **Minimum Purchase Amount:** Define the minimum amount required for the coupon to apply.
8. **Apply the Coupon:** Decide whether it applies to **All Orders** or **Specific Collections**.
Clients can specify whether the coupon should apply to **both merchants and collections (AND)** or **either merchants or collections (OR)**.
**General notes on "Display Name" and "Terms & Conditions":**
* Supports **multiple languages**, matching your widget's configured languages.
* **Customer-Facing Experience:** Customers see the **localized display name** in their widget, emails, and web messages. If no translation exists for a customer's language, the **default language name** is shown instead.
* **API Updates:** `displayName` is included in coupon API responses as a **multi-language object (key-value pairs)**. No breaking changes for existing API integrations.
* **Terms & Conditions Field:** A dedicated "Terms & Conditions" section is available when creating or editing manual coupons. The coupon API includes a `termsAndConditions` object containing multilingual key-value pairs with no impact on existing coupon API consumers.
#### How to distinguish regular coupons from automatic promotions
The **Customer Coupons API** makes it easier to distinguish **automatic promotions** from **regular coupons** and to display **promotion rules** that define how customers qualify for each offer:
* **`"isPromotion": false`** — Regular or manually issued coupon.
* **`"isPromotion": true`** — Promotion or rule-based discount (e.g., "Buy 2 Get 1 Free", "50% Off Collection").
A `promotionRules` object provides promotion details:
```json theme={null}
"promotionRules": {
"type": "Buy X Get Y",
"description": "Buy 2 items from Summer Collection, get 1 free T-shirt",
"conditions": {
"buyQuantity": 2,
"getQuantity": 1,
"applicableCollections": ["Summer Collection"],
"minOrderValue": 0
}
}
```
Includes promotion type and description, applicable collections or products, and minimum order value or eligibility rules.
Select the target audience for the coupon:
* **All Customers:** The coupon is accessible to all customers.
* **Specific Customers:** Target specific customer groups using:
* **Segments:** Based on predefined customer behaviors.
* **RFM Segments:** Utilizing Recency, Frequency, and Monetary metrics.
* **Tags:** Assign tags to filter customers.
* **Customer Attributes:** Filter by Customer ID or Customer Email.
Add optional configurations to customize the coupon further:
| Option | Description |
| -------------------------------------- | -------------------------------------------------------------- |
| **Start Date** | Specify when the coupon becomes active. |
| **End Date** | Specify when the coupon expires. |
| **Coupon Usage Per Customer Limit** | Set how many times an individual customer can use the coupon. |
| **Coupon Usage Limit** | Establish a total usage cap for the coupon. |
| **Reward Combined with Other Coupons** | Specify whether the coupon can be used alongside other offers. |
Once all details have been added, click the **Save** button to finalize your coupon.
***
## Manage Your Coupons Efficiently
### Edit Each Coupon
Click the **three-dot icon** beside any coupon to access management shortcuts:
| Action | Description |
| ----------------------- | ----------------------------------------------------------------------------------- |
| **Duplicate** | Create an identical copy of an existing coupon for similar campaigns or promotions. |
| **Activate/Deactivate** | Toggle the coupon's status to control its availability. |
| **Edit** | Update the coupon's details, including name, value, usage limits, and more. |
| **Delete** | Permanently remove a coupon. Deleted coupons cannot be recovered. |
### Configure Locking Coupon Duration
To set the duration during which coupons should be locked before they are usable, click **Settings** on the top right of the page.
Set up the time and click **Save**.
### Export Created Coupons
Click **Export**, then **Extract**.
***
## Related Articles
Learn about all the capabilities of Gameball's couponing engine.
Request coupon creation from your couponing engine via API.