Appearance
CP Overview
Creating and Managing Price Rules
The Store Price Rule module provides a comprehensive control panel interface for creating and managing sophisticated pricing rules. The interface is organized into logical sections to help you configure rules efficiently.
All rules are shown in one overview, Rules in the sidebar, grouped under a heading per group: Cart Rules, Product Rules and Buy X Get Y Free Rules. Here you can add, edit, delete and reorder the rules. The overview shows the name of the rule with its start and end date, the type of the rule with its code (when the rule is triggered by a code) and whether the rule is active.

Available from v2.0.0: use the filters above the overview to show only one group (type), only the active or inactive rules (status), or to search on the name or code of a rule. Rules whose end date has passed are hidden, they never apply anymore: choose Expired under status to see them. When you add a rule while the overview is filtered on a group, the first type of that group is already selected.
Every group is applied on its own, from top to bottom (see Rule Processing). With the up and down arrows you change the order within a group: a rule can't be moved to another group. The arrows are hidden when you filter on status or search, because then not all rules of a group are shown. The hidden expired rules are skipped when you move a rule.
Available from v2.0.0: the Used column shows in how many orders a rule is used (only the orders that count for the usage limits, so without cancelled, failed, expired and refunded orders), with its usage limit when it has one (e.g. 3 / 10). Click the number, or the receipt icon, to see the orders, see Usage.
When the Store Price Rule module is installed, it replaces the native discount system of the Store module: the Discount page and the discount settings of the Store module are no longer shown in the CP. The existing discounts of the Store module are converted to cart rules, a discount for reorders to a product rule with Only reorders and renewals (and deleted from the Store module), when you open this CP. See What changes in the Store module.
Basic Rule Settings

Name
Enter the name of this rule. This is only for your reference and helps you identify the rule in the overview.
Description
Enter a description for this rule. This is only for your reference and provides additional context about the rule's purpose.
Active
Enable or disable this rule. Inactive rules will not be applied to any orders.
Start Date
The start date after which this rule is active. Leave empty for no start date restriction. The rule will only be active from this date forward.
End Date
The end date after which this rule is no longer active. Leave empty for no end date restriction. The rule will automatically deactivate after this date.
Trigger Settings
Trigger by
Choose how this rule should be activated:
- Automatically when conditions are met: The rule will be applied automatically when all specified conditions are satisfied
- By code: Customers must enter a specific code in the coupon code field of the cart to activate this rule
Code (conditional field - only shown when "By code" is selected)
A code customers enter in the coupon code field of the cart to activate this rule. This allows you to create coupon-style discounts that require customer input.
- Every rule has its own code: a code that is already used by another rule (on any site, in any upper or lower case) is not accepted. Moved Store discounts can share a code with another rule, see How does it work; give one of them another code, until then neither of them can be saved.
- With By code the code is required.
- Upper and lower case don't matter. Spaces at the start and end of the code are removed when you save the rule, like the coupon field of the cart does.
The code is entered in the coupon code field of the Store cart (<input type="text" name="coupon_code" value="{cart:coupon_code}"/>, see the Cart tag of the Store module). The code is only accepted when a rule with that code exists, is active, is within its start and end date and its usage limits are not reached. When the other conditions of the rule are not met, the code is removed from the cart again (see Coupon codes).
Rule Types
The module supports three categories of price rules. The type is chosen when you create a rule and can't be changed afterwards.
Choose the type first when you create a rule. Only the fields of the chosen type are saved: a field that you filled in and that is hidden after choosing another type is saved empty.
Cart Rules
These rules apply to the entire cart and include:
- Cart percentage discount: Apply a percentage discount to the total cart value
- Cart fixed discount: Apply a fixed amount discount to the total cart value
- Free shipping: Remove shipping costs when conditions are met
Product Rules
These rules apply to specific products and include:
- Product percentage discount: Apply a percentage discount to qualifying products
- Product fixed discount: Apply a fixed amount discount to qualifying products
Buy X Get Y Free Rules
These rules add one or more free products to the cart:
- Buy X get Y free: When the conditions are met, the selected free products are added to the cart for free
Discount Value (conditional field - shown for all discount types except free shipping)
The discount value for the rule. For percentage discounts, enter the percentage (e.g., "10" for 10% off). For fixed discounts, enter the monetary amount (e.g., "10" for 10 off in the currency of the Store). The discount is calculated on the prices excluding tax. For product rules the discount is applied to the price per item.
The value can not be negative, and a percentage can not be more than 100. A fixed discount is never more than the price of the item (product rules) or the subtotal (cart rules; the shipping costs are never discounted).
Buy X Get Y Free Entry IDs (conditional field - only shown for Buy X get Y free)
Select the products (entries) that are added to the cart for free, at least one is required. Products that are also selected in Entry IDs are left out. The list shows the open entries of the channels that are enabled in the channel settings of the Store module.
The product price, name, SKU and weight are read from the fields set in the channel settings of the Store module, so make sure these are set for the channel. A product without a price (a price of 0 is fine), name or SKU is skipped; the weight counts for the shipping, without a weight field it is 0, and a product that is out of stock is not added (this is written to the log as an error, unless the log setting is set to nothing).
Conditions
Cart-Level Conditions (shown for cart rules and free shipping)
Minimum Cart Total
The minimum cart total (the subtotal of the cart excluding tax, after the product discounts) required for this rule to apply. Leave empty for no limit. This ensures the rule only applies to orders above a certain value.
Minimum Cart Quantity (shown for cart percentage and fixed discounts only)
The minimum total quantity of items in the cart (the free products of Buy X Get Y Free rules don't count) required for this rule to apply. Leave empty for no limit.
Product-Level Conditions (shown for product rules only)
Minimum Product Quantity
The minimum quantity of a product in the cart (the quantity of the cart item) required for this rule to apply. Leave empty for no limit.
Product Conditions (shown for cart, product and Buy X get Y free rules, not for free shipping)
Entry IDs
Select the products (entries) for this rule. Leave empty for all products.
- For a Cart Rule, the rule applies when any of these products is in the cart (a free product of a Buy X Get Y Free rule doesn't count).
- For a Product Rule, only these products get the discount. This allows you to create product-specific discounts.
- For a Buy X Get Y Free Rule, these are the products that need to be bought (the "X"): the free products are added when any of these products is in the cart, a free product of another Buy X Get Y Free rule doesn't count. When left empty, the free products are added as soon as any product is in the cart.
Reorders and Renewals
This condition is shown for all rule types.
Only reorders and renewals
Give the discount only on reorders and renewals: products in the cart that reorder or renew an earlier ordered product. Such a product is added to the cart with the reorder tag of the Store module, or with the parent_order_item_id param of the add to cart tag. Defaults to No.
- For a Product Rule, only these products get the discount; the other products in the cart keep their price.
- For a Cart Rule (also free shipping), the rule only applies when such a product is in the cart. With Entry IDs, it must be one of those products.
- For a Buy X Get Y Free Rule, the product that is bought must be such a product. With Entry IDs, it must be one of those products.
A free product of a Buy X Get Y Free rule doesn't count. With a code, the customer gets the coupon code error when the cart has no reorder or renewal.
It is checked every time the cart is calculated: the earlier order must be a paid order of the current visitor (not cancelled, refunded or charged back), for the same product. Without a limit, a paid order can give the discount as often as it is reordered.
Usage Limit Per Reorder
Shown when Only reorders and renewals is on. The number of times one ordered product can get this rule. With 1, a customer gets the discount once per ordered product: a second reorder from the same order is at the normal price, the renewal of that reorder gets it again. It is counted in orders like the other usage limits: a cancelled, failed, expired or refunded order doesn't count. An open order, or one that is pending on the review step of a gateway, doesn't count either, so a customer whose payment failed can try again with the discount. When an order that reaches the limit is paid, the other unpaid attempts of that customer with this rule for the same product are cancelled. A customer who pays an old payment page after that gets the warning of an order paid after it was cancelled on the order page in the CP, when the gateway reports it with a webhook; set up the webhook of your gateway for this. A payment that fails cancels nothing. More reorders of the same product in one order count as one. With a code, the order isn't placed when the limit is reached during the checkout, the customer gets the coupon code error. For a cart rule, each reordered product in the cart counts for the order. Leave empty for no limit.
Only up to the ordered quantity
Shown when Only reorders and renewals is on. No discount when more is reordered than was ordered: renewing 10 licenses gets the discount, reordering 11 of them is at the normal price for all 11. The customer can order the extra products separately. More cart items that reorder the same product count together.
Member and Role Targeting
These conditions are shown for all rule types.
Member IDs
Select specific members to which this rule applies. Leave empty to apply to all members. This allows you to create personalized discounts for specific customers.
Role IDs
Select specific member roles to which this rule applies. Leave empty to apply to all roles. Only the primary role of the member is checked, not the other roles of the member. This enables you to create discounts for customer segments like VIP members, wholesale customers, etc.
Usage Limits
A rule counts as used when an order is placed with that rule applied, once per order. See Usage limits for the details.
Usage Limit Total
The total number of times this rule can be used across all customers. Leave empty for no limit. This is useful for limited-time promotions or flash sales.
Usage Limit Per Member
The total number of times this rule can be used per customer: a logged in member by member or by the email address of the cart, a guest by the email address of the cart. Leave empty for no limit. See Usage limits.
Usage
Available from v2.0.0: the usage page of a rule (the receipt icon in the overview, or Used in ... orders under the name in the rule form) lists the orders that used the rule: the order number (a link to the order in the Store module), the date, the customer, the status and total of the order, and whether the order is counted for the usage limits.
Above the list you see how many orders count for the usage limits, how many are left of the Usage Limit Total and how many orders don't count. Cancelled, failed, expired and refunded orders are listed, but don't count (see Usage limits); an order that is still open or pending does count. Use the filters to show only the counted or not counted orders, the orders of a period, or to search on the order number, email address or name of the customer.

Settings
Enable Stacking Discounts
This allows you to stack each discount upon each other. Say you have a cart total of 100,- and you have defined 2 discount rules. Both with 10%. The first discount rule subtracts 10,- and the second one subtracts 9,-.
Rule of thumb: the second or later will always use the result of the previous discount.
When disabled, only the first matching rule is applied: the module stops at the first hit. This is checked separately for the cart rules, the product rules (per cart item) and the Buy X Get Y Free rules. A free shipping rule also counts as a hit, and a Buy X Get Y Free rule when at least one of its free products is in the cart.
The setting is off by default (Reinos Store 4.0.0 and later).
This is the same setting as the "Enable Stacking Discounts" setting of the Store module, which is hidden in the Store settings when this module is installed.
Logging Settings
What should be logged: only errors (the default), everything or nothing.
Logging
This is where you can track all logs related to price rule processing and application. You can delete a single log or delete all logs at once.
Available from v2.0.0:
- Filters: filter the logs by severity (error or notice), by date (a period or a custom range) and by a keyword in the message, and choose how many logs are shown per page. The filters are kept when you sort or go to another page.
- Bulk delete: select logs with the checkboxes and choose Delete in the bar at the bottom to delete them at once.
- Export logs: download the logs as a CSV file (separated by
;). The export contains the logs that match the active filters.
Delete all logs deletes the logs of the current site only.
