# Coupon Code Lists

The **Coupon Code Lists** section allows you to upload, manage, track, and distribute your existing coupon codes for promotional campaigns. From this page, you can review active lists, monitor availability, set expiry rules, and export usage data.

> **Important:** Netmera does **not** generate coupon codes. This feature only manages and distributes the coupon codes that you provide.

{% @arcade/embed flowId="hyRgFxR4qZlVPgiGEFTe" url="<https://app.arcade.software/share/hyRgFxR4qZlVPgiGEFTe>" %}

## Accessing Coupon Code Lists

Go to **Settings** in the left menu > **Coupon Code Lists**.

The dashboard displays an overview of all existing lists. Each list shows:

* **List Name**
* **Available Coupons** (remaining quantity)
* **Expiry Date**

This page helps you track inventory and plan replenishment before campaigns run out of codes.

<figure><img src="https://1642824329-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FX6uilbEAw42gqsudlclY%2Fuploads%2FQEMPByClGXdk6drZoxGW%2FScreenshot%202025-11-26%20at%2009.34.30.png?alt=media&#x26;token=98633d2f-a1c7-4ab0-94b9-4ba7a0634475" alt=""><figcaption></figcaption></figure>

## Uploading Coupon Code Lists

**List Name**

Enter a name that describes the purpose of the list. This name appears in your dashboard.

<figure><img src="https://1642824329-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FX6uilbEAw42gqsudlclY%2Fuploads%2FHZoUxbaqBV1Rr7CUkkbR%2FScreenshot%202025-11-26%20at%2009.34.57.png?alt=media&#x26;token=3387dfad-2daf-438b-af58-8f13a0d029c9" alt=""><figcaption></figcaption></figure>

**Adding Coupon Codes**

You can upload coupon codes using one o the following options:

### Option 1: Fixed Coupon Code

A **single code** shared by all users. Useful for sitewide promotions or general discount campaigns.

**How it works:**

* Select **Fixed Coupon Code**
* Enter the coupon value (e.g., `SALE10`)
* Enter how many times this code can be assigned

**Example use cases:**

* “10% off for everyone”
* General welcome discount
* Seasonal offers

<figure><img src="https://1642824329-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FX6uilbEAw42gqsudlclY%2Fuploads%2FA98dNQjQIfTnvBVIkEZo%2FScreenshot%202025-11-26%20at%2009.35.46.png?alt=media&#x26;token=73cde417-b44d-453e-aa6d-3fdfad608a28" alt=""><figcaption></figcaption></figure>

### Option 2: Coupon List (Unique Codes)

A list of **individual, unique codes**, each assigned once per user.

**How to prepare your file:**

* File type: **.txt**
* Format: **One code per line**
* No commas or extra formatting

**How Netmera uses it:**

* Each user receives a unique code
* Codes are distributed sequentially and marked as used

**Best for:**

* One-time gift codes
* Limited allocations
* High-value promotions

<figure><img src="https://1642824329-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FX6uilbEAw42gqsudlclY%2Fuploads%2Fp6uYmYDagerPqFDRBLFQ%2FScreenshot%202025-11-26%20at%2009.36.10.png?alt=media&#x26;token=d3705164-1416-4159-82cb-66c701c11667" alt=""><figcaption></figcaption></figure>

### Warning Limit

Set a threshold to receive email alerts when a list is running low.

* When remaining codes drop **below your threshold**, Netmera emails the assigned recipients
* Helps prevent campaigns from running out unexpectedly

**Example:** Warning Limit = 50 → You receive a warning email when the remaining codes reach 50.

### Expiry Date

Set the final date when the coupon codes can be used.

After the expiry date:

* Codes are automatically considered invalid
* Slices or widgets depending on this list may become inactive
* Related automated campaigns may auto-complete (see below)

<figure><img src="https://1642824329-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FX6uilbEAw42gqsudlclY%2Fuploads%2FE5RNRrJHctqJtg70hnGG%2FScreenshot%202025-11-26%20at%2009.36.27.png?alt=media&#x26;token=a45ad881-f348-4c6d-adab-ca35aa69ef85" alt=""><figcaption></figcaption></figure>

## Delivery Options: SMS and Push

After uploading your coupon list, you can automatically send coupon codes using:

* **SMS**
* **Push Notification**

Enable or disable each option depending on your campaign needs.

#### Send SMS

* SMS delivery uses predefined predefined active transactional messages.
* Insert `{couponcode}` and `{expirydate}`
* Requires previously created profile attributes used in the transactional message.
* Requires SMS integration

> **Note**\
> For SMS delivery to work, complete the SMS onboarding process before enabling this option.

<figure><img src="https://1642824329-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FX6uilbEAw42gqsudlclY%2Fuploads%2FuEYycSl00tQ2kWzZhyWH%2FScreenshot%202025-11-26%20at%2009.38.44.png?alt=media&#x26;token=e891c167-f2c7-4f4d-9eb0-6feec7cb5cba" alt=""><figcaption></figcaption></figure>

#### Send Push Notification

* Push notifications also use predefined active transactional messages.
* Insert `{couponcode}` and `{expirydate}`
* Requires previously created profile attributes used in the transactional message.

<figure><img src="https://1642824329-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FX6uilbEAw42gqsudlclY%2Fuploads%2FPtjFi27ndTA1TuvtpoWn%2FScreenshot%202025-11-26%20at%2009.39.48.png?alt=media&#x26;token=a26a868d-8302-4d55-b491-09b0af5dd7ce" alt=""><figcaption></figcaption></figure>

### Campaign-Level Distribution Rules

Netmera enforces a **24-hour distribution rule**:

* A user can receive **one** coupon code from the **same campaign ID** every **24 hours**
* If the campaign triggers again within this period, the user receives the **same code**, not a new one

This ensures fairness and prevents over-delivery.

## Campaign Completion Logic

Netmera automatically marks campaigns as **Finished** when:

#### All codes are used

* The list is empty
* Campaigns linked to this list automatically finish

#### The list has expired

* All campaigns connected to this coupon list also finish automatically

This applies to all features using coupon lists:

* Spin to Win
* Copy Button
* Any widget distributing coupon codes

## Editing Coupon Code Lists

To edit an existing list:

1. Go to **Coupon Code Lists**
2. Click **Edit**

You can update:

* Expiry date
* Coupon file (.txt)
* Fixed coupon details

This supports maintaining long-running campaigns without creating new lists.

<figure><img src="https://1642824329-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FX6uilbEAw42gqsudlclY%2Fuploads%2FhFMua71kQK0B3KMph2vb%2FScreenshot%202023-09-26%20at%2018.14.19.png?alt=media&#x26;token=1f2e2b60-1c20-4c8b-92aa-3face6a5c5a6" alt="" width="563"><figcaption></figcaption></figure>

## Exporting Coupon Code Usage

To export assigned coupon data:

1. Open **Coupon Code Lists**
2. Click **Export**

Your export includes:

* External ID
* User ID
* Assigned coupon code
* Timestamp

<figure><img src="https://1642824329-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FX6uilbEAw42gqsudlclY%2Fuploads%2FvljgSsApodi40409WRPt%2FScreenshot%202023-09-26%20at%2018.15.32.png?alt=media&#x26;token=e0bee439-fc2f-4722-90e1-d07dbbfe60ff" alt="" width="375"><figcaption></figcaption></figure>

## User Coupon Codes (Targeting)

Navigate to:\
**Targeting > User Details > Coupon Codes**

This page displays:

* All coupon codes assigned to a user
* When each code was delivered
* Full coupon history

This helps with customer support, segmentation, and troubleshooting.

<figure><img src="https://1642824329-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FX6uilbEAw42gqsudlclY%2Fuploads%2FqzQY5rWmbrBPC6kisGk3%2FScreenshot%202023-09-26%20at%2018.34.32.png?alt=media&#x26;token=de5adaef-c253-4fc2-851a-084798aab8e7" alt=""><figcaption></figcaption></figure>

## Sending Coupon Codes via SMS and Push

For details on combining coupon code lists with transactional messaging, refer to:

[#sending-coupon-codes-via-sms-and-push](#sending-coupon-codes-via-sms-and-push "mention")

## FAQs

#### Can Netmera generate coupon codes?

No. Netmera only manages and distributes the codes you upload.

#### Is there a limit to how many codes I can upload?

There is no strict limit. Large uploads are supported as long as system capacity is not exceeded.

#### Is there a limit to the number of coupon lists?

No. You can create as many lists as your campaigns require.

#### What file format should I use for uploading codes?

Use a **.txt** file with **one code per line**.

#### Can I edit an existing list?

Yes. You can edit expiry dates or upload a new set of codes using the **Edit** button.