# How to Create and Manage Coupons in Omnitron?

This tutorial provides step-by-step instructions for creating and managing coupons in Omnitron.

## <mark style="color:red;">Step 1: Navigate to Coupons Page​</mark> <a href="#step-1-navigate-to-coupons-page" id="step-1-navigate-to-coupons-page"></a>

* Navigate to the Omnitorn platform and log into your account.
* Follow the **Sales Channels** > **Marketing** sidebar and click the **Coupons** page.<br>

  <figure><img src="/files/O0QEhRrXUq6NCS4M9hej" alt=""><figcaption></figcaption></figure>
* On the Coupons page, the filter panel and the list of existing coupons are displayed.
* You can filter the coupons based on their characteristics such as Coupon Name, Discount Type, and more. The selected filters are displayed in the active filters row.

## <mark style="color:red;">Step 2: Creating a New Coupon​</mark> <a href="#step-2-creating-a-new-coupon" id="step-2-creating-a-new-coupon"></a>

* To create a new coupon, start by selecting a language from the available options. This language preference will determine the language of the coupon message and user warning messages.
* Then, click the **+ New Coupon** button located in the upper-right corner.<br>

  <figure><img src="/files/tvrZ7bHyK8OEaWNVvWuT" alt=""><figcaption></figcaption></figure>

### <mark style="color:red;">Coupon Information​</mark> <a href="#coupon-information" id="coupon-information"></a>

* This section is used to define the general information of the coupon.<br>

  <figure><img src="/files/qNtuRoqZUmyxGQXPJwqh" alt=""><figcaption></figcaption></figure>
* Fill in the required fields, including:
  * **Coupon Name:** The name of the coupon.
  * **Discount Slug:** Define a name for the coupon in your ERP system.
  * **User:** Choose which customers are eligible for the coupon.
  * **Coupon Message:** This message is shown to customers in the cart summary and search filters. Please make sure it is in the selected language.
  * **Maximum Number of Applications (Per Cart):** Specify the maximum number of times each customer can apply the coupon. Use "0" for unlimited uses.
  * **Priority:** Set the priority of the coupon in comparison to others. A lower value indicates higher priority, and negative values are allowed.
  * **Start/End Date and Time:** Define the valid date and time for the coupon.
  * **Status:** Toggle the status to activate or deactivate the coupon.
  * **Currency:** Select the currency for the coupon.
  * **Can be combined with other campaigns:** Choose whether the coupon can be combined with other active campaigns or discounts.
  * **Show on Product Detail:** Choose whether the coupon name should be displayed on the product detail page.
* Click **Save and Continue** after filling all necessary fields.

### <mark style="color:red;">Coupon Conditions​</mark> <a href="#coupon-conditions" id="coupon-conditions"></a>

* This section is used to define the conditions for the application of the coupon.<br>

  <figure><img src="/files/Ivb1DmRydrplwcBI1FsG" alt=""><figcaption></figcaption></figure>
* Fill in the required fields, including:
  * **Select a Collection:** Select the collection to which the coupon should apply.
  * **Primary Condition Type:** Select the primary condition type, such as Total Amount, Total Number of Products, or Payment Step Discount, and define specific conditions based on your selection.
    * (You can also define secondary conditions based on card types, installments, banks, payment types, minimum cart amount, email extensions, and more.)
  * **User Warning Message:** Customize the user warning message to encourage customers to meet the coupon conditions. Use placeholders like {remaining} to dynamically display information about what customers need to do to qualify for the coupon.
  * **Price Type:** Select the price type to determine the application condition related to pricing, such as Unit Price, Discount Price, or Retail Price.
  * **Application Type:** Select the application type to specify whether the coupon will be applied to all products or only to products without any pre-existing coupons.
* Click **Save and Continue** after filling all necessary fields.

### <mark style="color:red;">Coupon Action​</mark> <a href="#coupon-action" id="coupon-action"></a>

* This section is used to define the action of the coupon when customers meet the conditions.<br>

  <figure><img src="/files/cA5CsazuIj03D6o6RwOX" alt=""><figcaption></figcaption></figure>
* Fill in the required fields, including:
  * **Select a Collection**: Select the collection to which the coupon should apply.
  * **Action Type:** Select the action type that aligns with the specific discount or offer you want to provide, such as **Price Discount, Cheapest Item Free, Percent Discount, Free Shipping,** and more.
  * **Price Type:** Specify the price type to decide whether the discount will be applied to the **Unit Price** or the **Discount Price**.
  * **Application Type:** Set the application type to determine whether the coupon can be used in conjunction with other coupons or campaigns.
* Depending on your selection, configure the specific details of the action.
* Click **Save and Continue** after filling all necessary fields.

## <mark style="color:red;">Step 3: Review and Approve​</mark> <a href="#step-3-review-and-approve" id="step-3-review-and-approve"></a>

* On the Summary page, review all the Coupon Information, Conditions, and Actions.
* If everything appears correct, click the Approve button to finalize the discount code creation process.<br>

  <figure><img src="/files/rbYSd3uh6663pYBsf9j0" alt=""><figcaption></figcaption></figure>

## <mark style="color:red;">Step 4: Changing the Status of Coupons​</mark> <a href="#step-4-changing-the-status-of-coupons" id="step-4-changing-the-status-of-coupons"></a>

* Select the coupons you want to change the status of from the list.
* From the dropdown menu located at the top left of the list, click **Make Selected Active** if you want to activate the selected coupons, or click **Make Selected Passive** if you want to deactivate them.
* Click the **Apply** button.<br>

  <figure><img src="/files/MI7znRynH2x4nG9vAkn9" alt=""><figcaption></figcaption></figure>

## <mark style="color:red;">Step 5: Updating Coupons​</mark> <a href="#step-5-updating-coupons" id="step-5-updating-coupons"></a>

* To make updates, click on the row of an existing coupon in the list.
* You will be directed to the detail screen where you can make the necessary changes.<br>

  <figure><img src="/files/vJ4sSSZdX2qneWmsRnLo" alt=""><figcaption></figcaption></figure>


---

# 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.akinon.com/tutorials/omnitron/sales-channels/marketing/how-to-create-and-manage-coupons-in-omnitron.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.
