Promotions & Discounts feature overview

Edit on GitHub

The Promotions & Discounts feature enables product catalog managers to provide free value to their customers by discounting a percentage or a fixed sum of an order’s subtotal or an item’s price on predefined conditions.

Discount types

There are two discount types:

  • Voucher
  • Cart rule

A product catalog manager selects a discount type when creating a voucher or creating a cart rule.

Voucher

A Voucher is a discount that applies when a customer enters an active voucher code on the Cart page. Cart voucher

Once the customer clicks Redeem code, the page refreshes to show the discount name, discount value and available actions: Remove and Clear all. The Clear all action disables all the applied discounts. The Remove action disables a single discount. Cart voucher applied

Multiple voucher codes can be generated for a single voucher. The code has a Max number of uses value which defines how many times the code can be redeemed.

You can eneter codes manually or use the code generator in the Back Office. Generate codes

See Creating a Voucher to learn how a product catalog manager can create a voucher in the Back Office.

Cart rule

A Cart rule is a discount that applies to cart once all the decision rules linked to the cart rule are fulfilled.

The cart rule is applied automatically. If the decision rules of a discount are fulfilled, the customer can see the discount upon entering cart. Unlike with voucher, the Clear all and Remove actions are not displayed. Cart rule

See Creating a Cart Rule to learn how a product catalog manager can create a cart rule in the Back Office.

Decision rule

A decision rule is a condition assigned to a discount that should be fulfilled for the discount to be applied.

A discount can have one or more decision rules. Find an exemplary combination below:

PARAMETER RELATION OPERATOR VALUE
total-quantity equal 3
day-of-week equal 5

In this case, the discount is applied if the cart contains 3 items and the purchase is made on the fifth day of the week (Friday).

Multiple decision rules form a query. A query is a request for information based on the defined parameters. In the Discount feature, a query requests information from a cart to check if it is eligible for the discount. By specifying decision rules, you define the parameters of the query.

In the Back Office, a product catalog manager creates decision rules in a Query Builder. The decision rules created in the Query Builder are transformed into a single query.

The decision rules from the previous example look as follows in the Query Builder:

Query builder

A product catalog manager can enter the query manually as well.

The same decision rules look as follows as a plain query:

total-quantity = '3' AND day-of-week = '5'

You can switch between Query Builder and Plain query modes to see how the specified decision rules look in either of them.

Decision rules are combined with AND and OR combination operators. With the AND operator, all the rules should be fulfilled for the discount to be applied. With the OR operator, at least one of them should be fulfilled for the discount to be applied.

In the following example, for the discount to be applied, a cart should contain 3 items and the purchase should be made on Wednesday. AND operator

In the following example, for the discount to be applied, a cart should either contain 3 items or the purchase should be made on Wednesday. OR operator

Info

When rules are combined by the OR operator, they do not exclude each other. If a cart fulfills both such rules, the discount is still applied.

Decision rule group

A rule group is a separate set of rules with its own combination operator.

Decision rule group

With the rule groups, you can build multiple levels of rule hierarchy. When a cart is evaluated against the rules, it is evaluated on all the levels of the hierarchy. On each level, there can be both rules and rule groups.

Decision rule hierarchy

When a cart is evaluated on a level that has a rule and a rule group, the rule group is treated as a single rule. The diagram below shows how a cart is evaluated against the rules on the previous screenshot.

Discount threshold

Threshold is a minimum number of items in cart that should fulfill all the specified decision rules for the discount to be applied. The default value is 1 . It means that a discount is applied if at least one item fulfills the discount’s decision rules.

In the following example, the discount is applied if there are four items with the Intel Core processor in cart. Threshold

Discount application

Discount application is a discount configuration option that defines the products to which a discount is applied.

There are two types of discount application:

  • Query String
  • Promotional product

Query string

Query String is a discount application type that uses decision rules to dynamically define what products a discount applies to.

The discount in the example below, applies to white products. Query collection

The product selection based on the query string is dynamic:

  • If, at some point, the color attribute of a product changes from white to anything else, the product is no longer eligible to be discounted.
  • If, at some point, a product receives the white color attribute, it becomes eligible for the discount.

Promotional product

Promotional product is a discount application type that discounts a particular product, regardless of whether the product is added to cart or not.

When a promotional product is available to a customer, the discount name is not displayed in the overview section. Instead, the Promotional products section is displayed in the cart, allowing to add the available quantity of the product to cart. Promotional product

A product catalog manager selects the promotional product by entering an abstract product SKU in the Back Office. Also, they define the quantity of the product to be sold with a discount.

Collection - promotional product

Discount calculation

Calculation defines the value to be deducted from a product’s default price. There are two types of discount calculation:

  • Calculator percentage
  • Calculator fixed

With the calculator fixed type, the currency of the respective shop is used for calculation.

See examples in the table below.

PRODUCT PRICE CALCULATION TYPE AMOUNT DISCOUNT APPLIED PRICE TO PAY
€50 Calculator percentage 10 €5 €45
€50 Calculator fixed 10 €10 €40

A product catalog manager defines calculation when creating a voucher or creating a cart rule. Discount calculation

Discount exclusiveness

Discount exclusiveness defines if a discount value of a discount can be combined with the discount value of other discounts in a single order.

A product catalog manager defines calculation when creating a voucher or creating a cart rule. Exclusive discount

Exclusive discount

An exclusive discount is a discount that, when applied to a cart, discards all the other discounts applied to it. If a cart is eligible for multiple exclusive discounts, the highest-value discount is applied.

In the following example, a cart with the order total amount of €100 contains the following discounts.

DISCOUNT NAME DISCOUNT AMOUNT DISCOUNT TYPE EXCLUSIVENESS DISCOUNTED AMOUNT
D1 15 Calculator percentage Exclusive €15
D2 5 Calculator fixed Exclusive €5
D3 10 Calculator percentage Non-exclusive €10

The discount exclusivity is resolved as follows:

  1. The discounts D1 and D2 are exclusive, so the non-exclusive discount D3 is discarded.
  2. The discount D1 providers more free value than the discount D2.
  3. As a result, the discount D1 is applied.

Non-exclusive discount

A non-exclusive discount is a discount that can be combined with other non-exclusive discounts in a single order.

In the following example, a cart with the order total amount of €30 contains the following discounts.

DISCOUNT NAME DISCOUNT AMOUNT DISCOUNT TYPE EXCLUSIVENESS DISCOUNTED AMOUNT
D1 15 Calculator percentage Non-exclusive €15
D2 5 Calculator fixed Non-exclusive €5
D3 10 Calculator percentage Non-exclusive €10

As all the discounts are non-exclusive, they are applied together.

Discount validity interval

Validity interval is a time period during which a discount is active and can be applied.

If a cart is eligible for a discount outside of its validity interval, the cart rule is not applied. If a customer enters a voucher code outside of its validity interval, they get a “Your voucher code is invalid.” message.

A product catalog manager defines calculation when creating a voucher or creating a cart rule. Validity interval

BACK OFFICE USER GUIDES
Get a general idea of the Promotions & Discounts feature
Create a voucher
Create a cart rule
Manage discounts
Developer guides

Are you a developer? See Promotions & Discounts feature walkthrough for developers.