---
title: Working with product coupons
related:
- https://docs.kentico.com/13/e-commerce-features/managing-on-line-stores/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/13/e-commerce-features/managing-on-line-stores/customers.md) can exchange for financial discounts when purchasing selected [products](https://docs.kentico.com/13/e-commerce-features/managing-on-line-stores/products.md). If users enter the product coupon codes during the checkout process (customers on the live site), or while adding or editing [orders](https://docs.kentico.com/13/e-commerce-features/managing-on-line-stores/orders.md) (store managers in the administration interface), the system applies the discounts on the corresponding products.
> **Info:** If your site is configured to store prices without [tax](https://docs.kentico.com/13/e-commerce-features/configuring-on-line-stores/configuring-taxes.md) included (via the **Prices include tax** [setting](https://docs.kentico.com/13/configuring-xperience/managing-sites/configuring-settings-for-sites/settings-e-commerce.md)), product coupons are applied before the system calculates and adds tax to the price total.
## Adding and editing product coupons
To add product coupons:
1. Open the **Product coupons** application.
2. Click **Enter product coupon** to add a new product coupon. Click **Edit** () in the list to edit an existing product coupon.
3. Configure the product coupon properties. See the [Property reference](#reference) for detailed information.
4. Click **Save**.
5. Create or generate coupon codes on the **Coupons** tab. For more information, see: [Working with coupon codes](https://docs.kentico.com/13/e-commerce-features/managing-on-line-stores/discounts/working-with-coupon-codes.md)
If enabled and valid, the product coupon can be applied by customers during checkout or by store administrators when editing orders. You can now distribute the coupon codes among your customers via any available communication channels.
## Changing the priority of product coupons
Customers can enter multiple [coupon codes](https://docs.kentico.com/13/e-commerce-features/managing-on-line-stores/discounts/working-with-coupon-codes.md) per order and different product coupons can apply to the same product. To deal with such situations, each product coupon has a set priority. The priority is determined by the order of items in the product coupon listing. The higher a coupon is in the list, the higher its priority.
You can change the priority of your site's product coupons using drag-and-drop functionality:
1. Open the **Product coupons** application.
- The coupons are ordered in the list according to their current priority.
2. Drag coupons to different positions in the list using the **Move** () area.
- Alternatively, you can change the order by clicking **Other actions** () -> **Move up** or **Move down** for individual items.
3. (Optional) **Edit** () individual coupons and set the **Apply lower priority discounts** property as necessary (in the **Discount processing** section). If you disable this option for a product coupon, other coupons with a lower priority cannot be applied to the same order.
The system uses the configured priority when processing multiple product coupons for a single order.
If multiple percentage-based product coupons apply to the same product, they stack multiplicatively – each product coupon reduces the base price used by coupons with a lower priority. For example, if two 10% coupons apply to the same product, the total discount is 19% (10% for the first coupon, then 10% calculated from the reduced 90% price for the second coupon).
## Allowing customers to enter coupon codes
Learn how to add coupon code input fields to pages in:
- [Adding coupon code inputs to pages](https://docs.kentico.com/13/e-commerce-features/developing-on-line-stores/implementing-a-checkout-process/integrating-the-shopping-cart/adding-coupon-code-inputs-to-pages.md)
> **Note:** **Product coupon restrictions per order**
>
> When validating coupon codes, the system only accepts one code per product coupon for each order. For example, if a customer knows 2 different coupon codes from a single product coupon for a 10% discount on a product each, they can apply the codes to 2 different orders, but **cannot** apply both to a single order to get a 20% product discount.
> **Info:** To display information about applied product coupons on your store's checkout pages, you need to correctly format the data of the items in the current shopping cart. See [Integrating the shopping cart](https://docs.kentico.com/13/e-commerce-features/developing-on-line-stores/implementing-a-checkout-process/integrating-the-shopping-cart.md).
## Reference
| General | |
| ------------------------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Name | The name of the product coupon used throughout the administration interface, for example in the product coupon list.
The system can also display this name to customers when viewing [invoices](https://docs.kentico.com/13/e-commerce-features/configuring-on-line-stores/configuring-invoices.md), details on product or shopping cart pages, etc. |
| Code name | The unique identifier of the product coupon (for example used by developers in custom code).
Unless there is a reason to set a particular value, you can leave the default _(automatic)_ option, and the system generates an appropriate code name automatically. |
| Enabled | If selected, the product coupon can be applied to orders. If cleared, the coupon is disabled. |
| Discount scope | |
| Applies to | Determines whether the product coupon applies to:
Individual [products](https://docs.kentico.com/13/e-commerce-features/managing-on-line-stores/products.md)
Sections within the [product tree structure](https://docs.kentico.com/13/e-commerce-features/configuring-on-line-stores/configuring-products/configuring-product-structure.md) (all products under the selected sections)
[Departments](https://docs.kentico.com/13/e-commerce-features/managing-on-line-stores/products/categorizing-products/departments.md) (all products belonging to the selected departments)
[Brands](https://docs.kentico.com/13/e-commerce-features/managing-on-line-stores/products/managing-brands-and-manufacturers.md) (all products that have one of the selected brands assigned)
[Collections](https://docs.kentico.com/13/e-commerce-features/managing-on-line-stores/products/managing-product-collections.md) of products (all products that are assigned to one of the selected collections)
Choose one of the options and then select the **Products**, **Sections**, **Departments**, **Brands** or **Collections** to which the coupon's discount applies. |
| Excludes | You can optionally exclude products from the coupon's discount (unless the _Applies to_ property specifies individual products). The exclusion options allow you to specify [product sections](https://docs.kentico.com/13/e-commerce-features/configuring-on-line-stores/configuring-products/configuring-product-structure.md), [brands](https://docs.kentico.com/13/e-commerce-features/managing-on-line-stores/products/managing-brands-and-manufacturers.md) or [collections](https://docs.kentico.com/13/e-commerce-features/managing-on-line-stores/products/managing-product-collections.md).
Choose the _products in sections_, _products with brands_ or _products in collections_ option in the **Excludes** property and then select the **Excluded sections**, **Excluded brands** or **Excluded collections**. |
| Discount value | |
| Discount | Determines whether the product coupon applies a discount as a percentage or a fixed amount.
**percentage** – the price of all products to which the coupon applies is reduced by the specified percentage.
**fixed amount** – the price of all products to which the coupon applies is reduced by a specific amount in the site's [main currency](https://docs.kentico.com/13/e-commerce-features/configuring-on-line-stores/configuring-currencies.md).**Note:** **Note**: Fixed amount discounts apply separately to every product unit. For example, if a product coupon's fixed amount is 5 and an order contains 10 units of a product to which the discount applies, the total discount is 50. |
| Amount | Specifies the exact value of the product coupon's discount. The amount must be a valid decimal number.
If the amount is a percentage, enter a number between 0 and 100.
If the amount is fixed, enter a number greater than 0. |
| Target customers | |
| Available for | Determines which types of users are able to apply the product coupon:
**All visitors** – all customers can use the product coupon.
**Registered users** – only [registered customers](https://docs.kentico.com/13/e-commerce-features/managing-on-line-stores/customers.md) can use the product coupon.
**Registered users in selected roles** – only registered customers in selected [roles](https://docs.kentico.com/13/managing-users/role-management.md) can use the product coupon. To specify the roles:
Click **Select** to open the **Select roles** dialog.
Choose the required roles.
Click **Select**.**Tip:** You can add registered customers to roles in the **Customers** application while editing customers on the **Roles** tab. |
| Discount processing | |
| Apply lower priority discounts | Indicates whether other product coupons with a lower priority can be applied to the same order. If you clear the check box, the system does not accept [coupon codes](https://docs.kentico.com/13/e-commerce-features/managing-on-line-stores/discounts/working-with-coupon-codes.md) of product coupons with a lower priority for the given order (even for coupons that apply to different products).
If multiple percentage-based product coupons apply to the same product, they stack multiplicatively – each product coupon reduces the base price used by coupons with a lower priority. For example, if two 10% coupons apply to the same product, the total discount is 19% (10% for the first coupon, then 10% calculated from the reduced 90% price for the second coupon).
**Note**: To set the priority of product coupons, open the main list of coupons in the _Product coupons_ application and change the order of the items. |
| Valid to | Specifies the time and date until which the product coupon can be applied. If you leave the value empty, the coupon's is valid permanently (starting from the **Valid from** date). |
| Valid from | Specifies the time and date from which the product coupon can be applied. If you leave the value empty, the coupon can be applied at any time before the **Valid to** date. |