Documentation

Product Discounts

How to create Product Discounts.

A Product Discount applies to a specific Product or subset of Products based on the criteria you provide. They apply before adding a Product to the Cart, and are stored as a discounted price in the Prices tab of the Product Variant information screen. This makes them useful for displaying discounted or sale prices on a product information page.

They are useful when creating Discounts for the following scenarios:

  • Specific Products or SKUs, for example, a sale on a specific color of handbag
  • Subsets of Customers, for example, a “platinum members-only" sale
  • Subsets of Products, for example, a sale on all handbags or wallets
  • Business-defined Product Attributes, for example, a sale on products by a certain designer

The maximum number of Product Discounts that can be active at the same time is 500.

Product Discounts can take upto 15 minutes to fully apply. For more information, see Eventual Consistency.

Create a Product Discount

To create a Product Discount, do the following:

  1. Go to Discounts > Add discount or Discounts > Product discount list in the Merchant Center main menu.

  2. Click Add product discount.

  3. Enter the values for the following fields:

    • Product discount name (required): the display name for the Discount that can be localized.

    • Product discount description: a plain-text description of the Discount that can be localized.

    • Product discount key: a unique identifier key for the Discount.

    • Discount value (required): the Discount type (Relative or Absolute) and the percentage or amount.

    • Rank (sortOrder) (required): the relative importance of the Discount as a decimal value from 0 to 1. A larger value ranks higher.

      Product Discounts do not stack. Only the highest ranked Product Discount applies.

    • Valid from: the date/time from which the Discount is valid to apply to a Product.

    • Valid until: the date/time until which the Discount is valid to apply to a Product.

  4. In the Product discount rules section, select one of the following:

    • This discount applies to all products without restriction: applies the Discount to all Products in your Store.
    • This discount only applies to products...: applies the Discount to Products that satisfy the Product Discount rule. For more information, see Configure Product Discount rules.

  5. Click Save.

Discounts are always created in the deactivated state, and must be activated to take effect.

Configure Product Discount rules

If you select This discount only applies to products... in the rule builder, you can create a rule that applies a Product Discount to a subset of Products. To configure a rule, you must select a condition and define one or more rules for the condition.

Select a condition

product-discount-condition

You can select one of the following conditions:

  • ... if ALL of the following conditions are met: all rules defined must be true for the Discount to apply. The AND button is displayed when creating additional rules.
  • ... if ALL of the following conditions are NOT met: all rules defined must be false for the Discount to apply. The AND button is displayed when creating additional rules. You cannot define multiple rules with this operator type.
  • ... if ANY of the following conditions are met: any rule defined must be true for the Discount to apply. The OR button is displayed when creating additional rules.
  • ... if ANY of the following conditions are NOT met: any rule defined must be false for the Discount to apply. The OR button is displayed when creating additional rules. You cannot define multiple rules with this operator type.

Define a rule

A Discount rule comprises of the following:

  • A predicate, which identifies data in the commercetools Platform associated with a Product.
  • An operator, which checks the state of the data.
  • Values, which are input to check against the predicate data.

product-discount-predicate

In the above example, the predicate, operator, and value are Categories, is, and Hats, respectively.

The operators available depend on the type of data the predicate stores. For example, the Price predicate allows for greater-than or less-than comparisons, because price represents a number in a particular currency. However, the Product key predicate does not allow such a comparison because they are text strings.

To define a discount rule, do the following:

  1. Select a predicate from the first drop-down.

    By default, the drop-down does not show all predicates. Select Show more... in the drop-down to see the available predicates.

  2. Select an operator from the next drop-down.

  3. Enter or select a value (to compare to) in the input field.

    The field's input type changes based on the predicate and operator, and in some cases is not present at all.

  4. Optionally, define subgroups for a rule or additional rules using AND or OR buttons, if available.

    • Click Add Subgroup for this Rule and fill in the input fields as required to create a sub-group (nested) rule.
    • Click Add new rule and fill in the input fields as required to create a non-nested additional rule.

define-product-discount-rule

Activate a Product Discount

To activate a Product Discount, do the following:

  1. Select the Discount you want to activate.
  2. Click the Status toggle. activate-product-discount
  3. Click Activate discount in the dialog.

Duplicate a Product Discount

You can also duplicate an existing Product Discount to save time when setting up new Product Discounts. To duplicate a Product Discount, do the following:

  1. Select the Discount you want to duplicate.
  2. Click the Duplicate Product discount icon in the upper-right hand corner.
  3. Click Save.

By default, duplicated Discounts are not activated.