---
title: Example - Applying a catalog discount
related:
  - https://docs.kentico.com/k8/e-commerce-features/configuring-and-managing-your-store/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).

The example demonstrates an application of a catalog discount. The 10% discount is time-limited, targeted on your registered [customers](https://docs.kentico.com/k8/e-commerce-features/configuring-and-managing-your-store/customers.md), and applies to all [products](https://docs.kentico.com/k8/e-commerce-features/configuring-and-managing-your-store/products.md) from the _Clothing_ department. It is applied while editing an existing [order](https://docs.kentico.com/k8/e-commerce-features/configuring-and-managing-your-store/orders.md) in the administration interface, and while shopping on the live site.

The example uses the sample _E-commerce Site_.

## Adding a catalog discount

First, enter the catalog discount's general properties.

1. Open the **Catalog discounts** application.
2. Click **New catalog discount**.         

   - The system opens a page where you can specify the discount properties.
3. Enter the following values for the discount's properties:                

   - **Name**: Clothing department discounts
   - **Enabled**: Yes (checked)
   - **Discount**: By %
   - **Value**: 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

> **Note:** The values in this section can be invalid when you are going through the example.
>
> Make sure you specify a valid period.

To specify the catalog discount's period of validity:

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

   - **Valid from**:  11/15/2014 8:00:00 AM
   - **Valid to**: 12/23/2014 6:00:00 PM
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 **Customers** section.
   - **Only for these customers**: 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** section.          

**Selecting the discount rule**

1. Click **Edit**.

   - This opens the **Edit macro condition** dialog on the **Rule designer** tab.
2. Select the _**Product department is**_ rule in the right part of the dialog.

   ![Selecting the discount rule](https://docs.kentico.com/docsassets/k8/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.

   - This opens the **Set parameter value** dialog for the **department** parameter.
2. Select **Clothing** from the list of available departments.

   ![Specifying the rule's parameter](https://docs.kentico.com/docsassets/k8/example-applying-a-catalog-discount/specifying_rule_parameter.png "Specifying the rule's parameter")
3. Click **OK**.

   - The system closes the **Set parameter value** dialog.
4. Click **Save & Close** in the **Edit macro condition** dialog.

   - The system closes the dialog and saves the condition specifying the selected 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 the registered customers are eligible.

## Applying the catalog discount

### While editing an existing order 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/k8/e-commerce-features/configuring-and-managing-your-store/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/k8/example-applying-a-catalog-discount/applying_catalog_discount.png "Applying the catalog discount")

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

### While shopping on the live site

1. View the live site.

2. Sign in as a registered customer.

3. Select **Clothing -> T-shirts** in your on-line store main menu.

   - The system displays a list of all T-shirts that you offer in your on-line store.

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

4. Click **Add to cart** in the _Nike Race Day_ section.

   > **Note:** The product has product options. That's why the system now displays the product's details page.

5. Click **Add to cart** again.

   - The system displays the content of the registered customer's shopping cart with the catalog discount applied on the product.

     ![Viewing the product price detail](https://docs.kentico.com/docsassets/k8/example-applying-a-catalog-discount/product_price_detail.png "Viewing the product price detail")

If you now click **Check out**, you can continue with the [checkout process](https://docs.kentico.com/k8/e-commerce-features/configuring-and-managing-your-store/checkout-process.md).