Documentation

Promotions

Automatic discounts applied based on rules without coupon codes

Last updated: Feb 09, 2026

Promotions

Promotions are automatic discounts applied based on rules — no coupon code required. They can target catalog prices, cart totals, or specific purchase patterns.

Promotion Listing

ColumnDescription
PromotionName and description
DiscountDiscount type and value
BadgeWhether a badge is shown on products
UsageNumber of times applied
ScheduleStart and end dates
StatusActive or Inactive
ActionsEdit, Delete, Toggle Status

Creating / Editing a Promotion

FieldRequiredDescription
Promotion NameDisplay name of the promotion
Promotion TypeSee promotion types below
Discount TypePercentage % or Fixed Amount $
Discount ValueNumeric discount value
Maximum Discount AmountCap on the discount (for percentage types)
DescriptionCustomer-facing description
PriorityProcessing order (lower = higher priority)
Internal NotesAdmin-only notes
Show Badge on ProductsToggle — displays a promotional badge on qualifying products
Show Countdown TimerToggle — displays a countdown to promotion end on the storefront
Total Usage LimitMaximum total applications
Per Customer Usage LimitMaximum applications per customer
Stackable with Other PromotionsToggle — allow combining with other active promotions
Stackable with CouponsToggle — allow combining with coupon codes
Stop Further Rules ProcessingToggle — when triggered, prevents lower-priority promotions from applying
Start Date & TimeWhen the promotion activates
End Date & TimeWhen the promotion deactivates
ActiveToggle to enable/disable

Promotion Types

TypeDescription
Catalog Price RuleAdjusts the displayed product price in catalog listings and product pages. Discount is applied before the product is added to cart.
Cart Price RuleApplies a discount to the cart total during checkout. Works similarly to coupons but is automatic.
Bundle DealOffers a discount when specific products are purchased together (e.g., "Buy shampoo + conditioner, save 15%").
Flash SaleA time-limited promotion with optional countdown timer. Creates urgency for customers.
Tiered PricingOffers increasing discounts based on quantity purchased (e.g., 1–9 units: 0% off; 10–49 units: 10% off; 50+: 20% off).