---
title: Example - Applying a catalog discount
related:
  - https://docs.kentico.com/k12sp/e-commerce-features/managing-on-line-stores/discounts/working-with-catalog-discounts.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).

This example demonstrates an application of a catalog discount. The example uses the sample _E-commerce Site_.

We want a 10% discount, that is time-limited, targeted at registered [customers](https://docs.kentico.com/k12sp/e-commerce-features/managing-on-line-stores/customers.md), and applies to all [products](https://docs.kentico.com/k12sp/e-commerce-features/managing-on-line-stores/products.md) from the _Clothing_ department. The system applies the discount while shopping on the live site, and while editing existing [orders](https://docs.kentico.com/k12sp/e-commerce-features/managing-on-line-stores/orders.md) in the administration interface.

## Adding a catalog discount

First, enter the catalog discount's general properties.

1. Open the **Catalog discounts** application.
2. Click **New catalog discount** to open a page where you can specify the discount properties.
3. Enter the following values for the discount's properties:

   - **Name**: Clothing department discount
   - **Enabled**: Yes (selected)
   - **Discount**: Percentage
   - **Amount**: 10
4. Click **Save**.

The system saves the catalog discount. Currently, the discount applies to all products, there is no time limit, and all customers are eligible.

### Limiting the discount's validity

To specify the catalog discount's period of validity:

1. Enter the properties in the **Duration** category.

   - **Valid from**: 11/15/2017 8:00:00 AM
   - **Valid to**: 12/23/2017 6:00:00 PM

     > **Tip:** To see how the discount applies to products on the site, adjust the validity to include the current date.
2. Click **Save**.

The system saves the catalog discount. Currently, the discount applies to all products, there is a time limit specified, and all customers are eligible.

### Specifying the discount's customer target group

To specify the catalog discount's customer target group:

1. Enter the properties in the **Target customers** category.
   - **Available for**: Registered users
2. Click **Save**.

The system saves the catalog discount. Currently, the discount applies to all products, there is a time limit specified, and only the registered customers are eligible.

### Limiting the discount's product scope

To limit the catalog discount's product scope, specify the **Apply to** property in the **Basics** category.

**Selecting the discount rule**

1. Click **Edit** to open the **Edit macro condition** dialog.
2. Select the _**Product department is**_ rule in the right part of the dialog.

   ![Selecting the discount rule](https://docs.kentico.com/docsassets/k12sp/example-applying-a-catalog-discount/selecting_discount_rule.png "Selecting the discount rule")
3. Click **Add rule** () to add the selected rule to the condition.

**Specifying the rule's parameter**

1. Click select department in the left part of the dialog to open the **Set parameter value** dialog.
2. Select **Clothing** from the list of available departments.

   ![Specifying the rule's parameter](https://docs.kentico.com/docsassets/k12sp/example-applying-a-catalog-discount/specifying_rule_parameter.png "Specifying the rule's parameter")
3. Click **Set parameter** to close the **Set parameter value** dialog.
4. Click **Save & Close** in the **Edit macro condition** dialog to save and close the dialog specifying the product scope.
5. Click **Save**.

The system saves the catalog discount. Currently, the discount applies to all products from the **Clothing** department, there is a time limit specified, and only registered customers are eligible.

## Applying the catalog discount

### While shopping on the live site

1. View the live site.
2. Sign in as a registered customer.
3. Select **Clothing -> T-shirts** in the on-line store's main menu.

   - The system displays a list of all T-shirts offered in the store.

> **Info:** The system offers all clothing with a 10% discount to the registered customer.
>
> ![Offering discounted T-shirts](https://docs.kentico.com/docsassets/k12sp/example-applying-a-catalog-discount/offering_discounted_tshirts.png "Offering discounted T-shirts")

4. Click **Add to cart** next to the _Nike Race Day_ product.

   > **Note:** The product has product options, so the system now displays the product's details page.
5. Click **Add to cart** again.

   - The system displays the product's unit price in the shopping cart with the catalog discount applied.

If you now click **Check out**, you can continue with the [checkout process](https://docs.kentico.com/k12sp/e-commerce-features/configuring-on-line-stores/checkout-process.md).

### While editing existing orders in the administration interface

1. Open the **Orders** application.
2. **Edit** () the selected order of a registered customer.
3. Switch to the **Items** tab.
4. Add the _Nike Race Day_ T-shirt.

   1. Click **Add item**.

      - The system opens the **Add order items** dialog.
   2. Select the _Nike Race Day_ T-shirt.

      > **Note:** Click the name of the product leaving the **Quantity** field empty. The system opens the **Add order items** dialog with the product details displayed.
      >
      > The system behaves like this because the product has [product options](https://docs.kentico.com/k12sp/e-commerce-features/managing-on-line-stores/products/working-with-product-options.md).
   3. Specify the amount of product items:
      - **Units**: 1
   4. Click **Add to cart**.

      - The system closes the dialog and applies the catalog discount.

        ![Applying the catalog discount](https://docs.kentico.com/docsassets/k12sp/example-applying-a-catalog-discount/applying_catalog_discount.png "Applying the catalog discount")

The catalog discount is included in the displayed **Unit price**. If you view the **Price detail** (), you can see a detailed summary of all applied discounts.

If you now click **OK**, the system saves the order.