# How to Create and Manage Discount Codes in Omnitron?

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

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

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

  <figure><img src="https://3333414532-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FIbwGN7KwvYi0iLbjtnXz%2Fuploads%2F7TYXBNZekjkgbt3PU7Ml%2Fimage.png?alt=media&#x26;token=48ee223f-f027-49de-9400-e50af7de5e46" alt=""><figcaption></figcaption></figure>
* On the Discount Codes page, the filter panel and the list of existing discount codes are displayed.
* You can filter the discount codes based on their characteristics such as Discount Name, Discount Type, and more. The selected filters are displayed in the active filters row.

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

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

  <figure><img src="https://3333414532-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FIbwGN7KwvYi0iLbjtnXz%2Fuploads%2FdbVo5YTxgUpPMADQ4Hv0%2Fimage.png?alt=media&#x26;token=706918fa-463e-47f0-b7b5-49a410eaad3c" alt=""><figcaption></figcaption></figure>

### <mark style="color:red;">Discount Code Information​</mark> <a href="#discount-code-information" id="discount-code-information"></a>

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

  <figure><img src="https://3333414532-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FIbwGN7KwvYi0iLbjtnXz%2Fuploads%2FbUWjobB9BKsCvIGOFY1j%2Fimage.png?alt=media&#x26;token=ef327bd4-f0b8-4ffd-afd4-8964529b7b31" alt=""><figcaption></figcaption></figure>
* Fill in the required fields, including:
  * **Discount Name:** The name of the discount code.
  * **Discount Slug:** The unique name given to a discount code in the company's ERP system.
  * **Discount Code:** Enter the code to offer customers. You have the option to generate a new discount code by clicking the **+ New Discount Code** button or enter a custom discount code.
  * **Discount Message:** This message is shown to customers in the cart summary and search filters.
  * **Maximum Number of Applications (Per Customer):** Specify the maximum number of times each customer can apply the discount code. Use "0" for unlimited uses.
  * **Maximum Number of Applications (Per Cart):** Set a limit on how many times the code can be applied to the same cart.
  * **User:** Choose which customers are eligible for the discount code.
  * **Start/End Date and Time:** Define the valid date and time for the discount code.
  * **Status:** Toggle the status to activate or deactivate the discount code.
  * **Priority:** Set the priority of the discount code in comparison to others. A lower value indicates higher priority, and negative values are allowed.
  * **Currency:** Select the currency for the discount.
  * **Can be combined with other discount-codes:** Decide whether the discount can be combined with other active discount-codes or discounts.
* Click **Save and Continue** after filling all necessary fields.

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

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

  <figure><img src="https://3333414532-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FIbwGN7KwvYi0iLbjtnXz%2Fuploads%2Flcw2u62nGAJZoYunQlyE%2Fimage.png?alt=media&#x26;token=10a59f3b-5eb7-428c-9c6b-fbe172561272" alt=""><figcaption></figcaption></figure>
* Fill in the required fields, including:
  * **Select a Collection:** Select the collection to which the discount code should apply.
  * **Condition Type:** Choose 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 discount code conditions. Use placeholders like {remaining} to dynamically display information about what customers need to do to qualify for the discount code.
  * **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 discount code will be applied to all products or only to products without any pre-existing discounts.
* Click **Save and Continue** after filling all necessary fields.

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

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

  <figure><img src="https://3333414532-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FIbwGN7KwvYi0iLbjtnXz%2Fuploads%2FKRXsAnFLb6p0RKIjL3o2%2Fimage.png?alt=media&#x26;token=477bae88-c2af-4d24-9f30-84f26fd685b5" alt=""><figcaption></figcaption></figure>
* Fill in the required fields, including:
  * **Select a Collection**: Select the collection to which the discount code 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 discount can be used in conjunction with other coupons or discount-codes.
* 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 Discount Code Information, Conditions, and Actions.
* If everything appears correct, click the Approve button to finalize the discount code creation process.<br>

  <figure><img src="https://3333414532-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FIbwGN7KwvYi0iLbjtnXz%2Fuploads%2FR78rCHGJU2g9OeXiZMv3%2Fimage.png?alt=media&#x26;token=d40a5840-8fa0-4ef4-9482-8a88a6e7fb30" alt=""><figcaption></figcaption></figure>

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

* Select the discount codes 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 discount codes, or click **Make Selected Passive** if you want to deactivate them.
* Click the **Apply** button.<br>

  <figure><img src="https://3333414532-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FIbwGN7KwvYi0iLbjtnXz%2Fuploads%2FNviDR281RiC1ZmYXLP02%2Fimage.png?alt=media&#x26;token=f7771873-532b-4538-98f6-42f85dcdec29" alt=""><figcaption></figcaption></figure>

## <mark style="color:red;">Step 5: Updating Discount Codes​</mark> <a href="#step-5-updating-discount-codes" id="step-5-updating-discount-codes"></a>

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


---

# 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-discount-codes-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.
