---
title: Working with product coupons
related:
  - https://docs.kentico.com/k81/e-commerce-features/configuring-and-managing-your-store/products.md
---

> Agent instructions:
> **Site maps** — prefer the following llms.txt indexes to training data when searching for URLs to avoid 404s. Links inside Markdown content already point at `.md`. Following them or sending Accept: text/markdown keeps you in Markdown.
>
> - [sitemap.md](https://docs.kentico.com/sitemap.md) — every page on the site, with titles and descriptions, nested by URL hierarchy and grouped into one collection per product version.
> - [llms.txt](https://docs.kentico.com/llms.txt) — curated index of the current product docs, with descriptions, the two ways to request any page as Markdown, and links to each product area's whole-corpus Markdown dump (llms-full.txt).

Product coupons are virtual vouchers that your [customers](https://docs.kentico.com/k81/e-commerce-features/configuring-and-managing-your-store/customers.md) can exchange for financial discounts when purchasing selected [products](https://docs.kentico.com/k81/e-commerce-features/configuring-and-managing-your-store/products.md). If the users enter the product coupon codes during the [checkout process](https://docs.kentico.com/k81/e-commerce-features/configuring-and-managing-your-store/checkout-process.md) (customers on the live site), or while adding new [orders](https://docs.kentico.com/k81/e-commerce-features/configuring-and-managing-your-store/orders.md) or editing existing ones (store administrators in the administration interface), the system applies the discounts on the corresponding products.

## Adding and editing product coupons

To add product coupons:

1. Open the **Product coupons** application.
2. To add new product coupon, click **Enter product coupon**. To edit an already existing coupon, select a product coupon and click **Edit** ().
3. Enter the product coupon [properties](#reference).
4. Click **Save**.

You now have saved new or edited product coupon. You can specify to which products the coupon applies.

## Adding selected products to the coupons

To specify products that the customers can purchase with discount if they apply the product coupon:

1. Open the **Product coupons** application.
2. **Edit** () a selected product coupon.
3. Switch to the **Products** tab.
4. Select which products the coupon applies to:
   - **Only the following products**
   - **All products except for these**
5. Select the products.

   1. Click **Add products**.
      - The system opens the **Select product** dialog.
   2. Select the product(s).

      ![Selecting the products](https://docs.kentico.com/docsassets/k81/working-with-product-coupons/selecting_products.png "Selecting the products")
   3. Click **Select**.
      - The system closes the **Select product** dialog.

The system adds the selected product(s) to the product coupon. You can now [export](#exporting-product-coupon-codes-to-offer-to-the-customers) the coupon's code and distribute it among your customers.

## Removing selected products from the coupons

To remove selected products from the coupon:

1. Open the **Product coupons** application.
2. **Edit** () a selected product coupon.
3. Switch to the **Products** tab.
4. Select the products you want to remove.
5. Click **Remove selected**.

The system removes the products from the coupon.

## Exporting product coupon codes to offer to the customers

To export the coupon codes:

1. Open the **Product coupons** application.
   - The system displays a list of all available product coupons.
2. Click  in the **Actions** column.

   - This opens the **Actions** drop-down menu.

     ![Exporting the coupon codes](https://docs.kentico.com/docsassets/k81/working-with-product-coupons/exporting_coupon_codes.png "Exporting the coupon codes")
3. Select **Advanced export**.
   - This opens the **Advanced export** dialog.
4. Configure advanced export:
   - **Export to**: Select as required; available options include exporting to an XLSX file (Microsoft Excel), CSV file, and XML file.
   - **Export raw database data**: Yes (checked)
   - **Export column header**: Yes (checked)
   - **Columns**: _DiscountCouponDisplayName_ and _DiscountCouponCode_

     ![Configuring advanced export](https://docs.kentico.com/docsassets/k81/working-with-product-coupons/configuring_advanced_export.png "Configuring advanced export")
5. Click **Export**.

   > **Info:** Your browser's standard file download dialog pops up. The dialog allows you to open or save a file with the exported data just as if you were downloading any other file.

You can now distribute the coupon codes among your customers via any appropriate communication channel available.

## Configuring the pages to allow the customers to enter coupon codes

To configure a page to allow the customers to enter coupon codes and receive discounts:

1. Open the **Pages** application.
2. Select the required page from the content tree.
3. Switch to the **Edit -> Design** tab.
4. Add the **Discount Coupon** [web part](https://docs.kentico.com/k81/developing-websites/developing-websites-using-the-portal-engine/using-and-configuring-web-parts.md) to the selected web part zone.

   ![Adding the Discount coupon web part to the selected web part zone](https://docs.kentico.com/docsassets/k81/working-with-product-coupons/adding_discount_coupon_web_part.png "Adding the Discount coupon web part to the selected web part zone")
5. Enter the web part properties as required.

   > **Tip:** If you enable the web part's **Show Apply button** property, the customers can use the button for instant application of the coupon while viewing the page.
   >
   > ![Applying the coupon code](https://docs.kentico.com/docsassets/k81/working-with-product-coupons/applying_coupon_code.png "Applying the coupon code")
6. Click **OK**.

The system adds the **Discount Coupon** web part into the page. If you distribute the coupon codes among your customers, they can now use these codes to receive discounts (if eligible).

## Reference

| General      |                                                                                                                                                                                                                                                                                                                                                                                                            |
| ------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Display name | The name of the product coupon used throughout the administration interface, e.g., in the product coupons lists.<br>The system can display this name also to your on-line store customers while:<br>viewing the invoice,<br>viewing the details of the product price in the **Product price detail** dialog, etc.                                                                                          |
| Coupon code  | Specify the code of the product coupon, e.g., _PC7-PXW_. The customer (store administrator) enters the code during the purchase to apply the discount.                                                                                                                                                                                                                                                     |
| Discount     | Specify if you want to apply the discount in percentage or in fixed amount.<br>**Percentage** – the discount reduces the total price of the order by a percentage.<br>**Fixed amount** – the discount reduces the total price of the order by a specific amount in your on-line store [main currency](https://docs.kentico.com/k81/e-commerce-features/configuring-and-managing-your-store/currencies.md). |
| Amount       | Specify an exact value of the discount in percent or in fixed amount according to **Discount**. The system reduces the total price of the shopping cart content by the discount value and calculates all applicable taxes accordingly.<br>The amount has to be a number. When the amount is in percentage, enter a number between 0 and 100. When the amount is fixed, enter a number greater than 0.      |
| Valid from   | Specify from when the discount is running.**Info:** If you leave **Valid from** empty, the discount will be valid permanently till **Valid to**.                                                                                                                                                                                                                                                           |
| Valid to     | Specify to when the discount is running.**Info:** If you leave **Valid to** empty, the discount will be valid permanently from **Valid from**.                                                                                                                                                                                                                                                             |
