Buy X get Y and tier deals in CS-Cart.

Buy 2 get the cheapest free, every third item half price, 10% off from 3 items and 15% from 5, lunch-hour deals on weekdays. New conditions and bonuses inside the promotion editor you already use.

  • v1.0.0
  • CS-Cart 4.17.2 – 4.21.x, Multi-Vendor
  • 30-day refund on a first purchase
Cart lines with "Buy 2, get the cheapest free: 1 × free −$16.97" and "Volume discount: 10% off −$9.90".
Cart totals with the applied promotions.
Checkout: the order summary shows the notes per line.
Admin order details: each discounted line shows its note.

The problem

Why core promotions stop short

CS-Cart promotions cover simple discounts and coupons. Retail classics such as "buy 2, get the cheapest free" or "every third item half price" need workarounds or one add-on per condition.

And on a marketplace, every vendor suborder has to get exactly its share of the discount.

Three ways to run retail-style deals

ApproachHow it worksTrade-off
Coupons onlyHand out codes and calculate the deal by hand.Shoppers must know the code; complex deals are impossible.
One add-on per deal typeInstall a separate add-on for BOGO, tiers and time windows.Add-ons conflict, and stacking rules become unclear.
New conditions in the core editorWhat Advanced Promotions: Buy X Get Y, Tiers, Schedules doesAdd the new conditions and bonuses to core promotions; coupons, dates and priorities keep working.Promotions stay in one place, so you still need a clear priority order.

Advanced Promotions: Buy X Get Y, Tiers, Schedules

How it works

  1. 01

    Add a cart promotion

    Open Marketing > Promotions and pick the new conditions and bonuses next to the core ones.

  2. 02

    Choose the products

    By products, categories with subcategories or Multi-Vendor vendors, with exclusions for sale items and already discounted items.

  3. 03

    Shoppers see the deal

    Cart, checkout and order details show a short note such as "Buy 2, get the cheapest free: 1 × free". Each vendor suborder gets exactly its share.

What you get

Buy X get Y

From the same set or another set, free or discounted, repeatable, with a limit.

Cheapest or N-th item

Cheapest item free, most expensive first, or every N-th item discounted.

Tier tables

By quantity or spend: percent off, amount off each item or amount off the total.

Time windows

Days and hours, including windows past midnight.

Limits and caps

Uses per customer by account or e-mail, and a discount cap per promotion.

Exact cents

Line discounts with taxes, coupons, currencies and Multi-Vendor suborders handled.

Made for

  • Fashion multi-buys
  • Grocery and FMCG
  • Bundles and accessories
  • Happy-hour deals
  • B2B volume tiers
  • Marketplace campaigns

Advanced Promotions: Buy X Get Y, Tiers, Schedules

Screenshots

The offers CS-Cart promotions cannot express

CS-Cart’s promotion editor handles coupons, order discounts, free shipping and gifts well. It has no way to say "buy 2, get the cheapest free", "every third item half price", or "10% off from 3 items and 15% from 5". Stores end up with one add-on per offer type, or a discount on everything because that is the easy option.

Advanced Promotions adds new conditions and bonuses to the same editor. It does not replace anything: coupons, dates, priorities, user groups, storefronts and Stop other rules keep working, and you stay in Marketing, Promotions.

Buy X get Y and other promotion recipes

Common promotions and how to build them
OfferBonus or condition to use
Buy 2 get the cheapest freeBuy X get Y, same set, Free, Cheapest items first, Repeat on
Every third item half priceBuy X get Y, buy 2 get 1, 50% off
Buy a camera, bag at 30% offBuy X get Y, another set for the get items
10% from 3 items, 15% from 5Tiered discount, count by quantity, up to six rows
Spend 100 save 10, spend 200 save 25Tiered discount, count by subtotal, amount off the total
20% off everything except sale itemsDiscount on a product set, with Skip sale items
Lunch-hour deal on weekdaysDay and time condition
At most three uses per customerUses per customer condition

With the same set, every complete group of X + Y items earns Y discounted items, picked from the whole cart. Buy 2 get 1 free with 6 items gives 2 free. A limit (At most N times) and a discount cap keep the cost of a campaign known.

Time windows use the store time zone and can run past midnight: 22:00 to 02:00 belongs to the day it starts. New conditions combine with core ones in all or any groups.

Product sets and exclusions

Every condition and bonus works on a product set: all products, or selected products, categories (with subcategories) and, on Multi-Vendor, vendors. Exclusions then remove products, categories and vendors, and two switches protect margin: Skip items that already have a discount, and Skip sale items, meaning items with a list price above the price.

Free gift lines and zero-price lines are never counted or discounted, so a free gift cannot trigger another offer.

How the discount reaches taxes, totals and vendors

This is where promotion add-ons usually cause problems, so it is worth knowing. The discount of a line is spread over its units and written like a core product discount, so taxes use the discounted price in both tax calculation methods. Percentages come from the line’s current price, after catalog promotions and higher-priority promotions. A line never goes below zero.

A discount that does not split evenly leaves a cent or two: one free item out of three at $16.97. With Exact order total, the default, the remainder goes into the order discount so the total is right, and you may see an order discount of $0.01. Round per unit avoids that line, but the total can differ by a cent.

Each discounted line carries a note in the cart, checkout and order details, for example "Buy 2, get the cheapest free: 1 × free −$16.97". Clear notes mean fewer questions. On Multi-Vendor, the split is kept exactly in every vendor suborder. With Direct Customer-to-Vendor Payments each vendor’s cart is calculated on its own, and vendors who may manage promotions see the same editor, limited to their own products.

Limits worth knowing

  • The new conditions and bonuses are for cart promotions, not catalog promotions, so the offer appears in the cart. Product page prices stay the same, which keeps them cache-friendly. To show the offer on product pages, use a banner or Product Labels & Stickers Pro.
  • Tier tables have up to six rows.
  • Amounts are in the primary currency, and shoppers see them converted.
  • Editing a placed order keeps the stored discounts, as with core product discounts.
  • Cart notes need a theme based on Responsive: Responsive, Bright, Nova and most third-party themes qualify.

One add-on or several single-offer add-ons?

Promotion options on CS-Cart
Core promotionsOne add-on per offerThis add-on
Buy X get YFree product onlyYesYes, with sets and repeat
Tier tablesNoSometimesQuantity or spend
Day and time windowsDatesSometimesWeekday and time
ExclusionsLimitedVariesProducts, categories, vendors, sale items
Where you editPromotionsSeveral screensPromotions

If you run a seasonal coupon and nothing else, core promotions are enough. For bundle pricing on selected products, Frequently Bought Together & Cross-sell offers an optional bundle discount. If vendors want to run their own campaigns, see Vendor Coupons & Automatic Sales. Get Advanced Promotions on the store.

Versions and requirements

CS-Cart and Multi-Vendor 4.17.2 to 4.21.x on PHP 7.2.5 to 8.3. The add-on works inside the core promotion calculation, with no own tables or remote calls, and prints nothing on cacheable pages. On Ultimate, settings can differ per storefront. Turning off Apply the add-on’s conditions and bonuses stops only its offers; core promotions keep working.

CS-Cart

Advanced Promotions: Buy X Get Y, Tiers, Schedules at a glance

Buy X get Y, cheapest or N-th item free, tier tables, day and time windows, product sets with exclusions and per-customer limits as new conditions and bonuses of CS-Cart cart promotions. Exact to the cent, with discount notes in the cart and orders.

Price
CS-Cart $99 · Multi-Vendor $129 (one-time)
Version
1.0.0
Compatible with
CS-Cart 4.17.2 – 4.21.x, Multi-Vendor
Licence
One production store, perpetual, 12 months of updates and support
Refund
30-day refund on a first purchase

CS-Cart

The CS-Cart products stores buy first

The most requested products on this platform. Each one has its own page, and you can buy it straight on the sales site.

Shop CS-Cart on our sales site

Prices, licences, full documentation and instant downloads are on the store.

cs-cart.kaviolabs.com · 98 add-ons · 29 themes

Advanced promotions

The same feature on other platforms

Built natively for each platform, not ported. Each version has its own product page, documentation and price.

FAQ

Questions and answers

Do core coupons and priorities keep working?

Yes. Core coupons, dates, priorities and the stop-other-rules option keep working.

How are discounts split on Multi-Vendor?

Every vendor suborder gets exactly its share of the discount.

Is it cache-friendly?

Yes. Pages stay cache-friendly.

Can I exclude sale items?

Yes. Exclusions cover products, categories, vendors, already discounted items and sale items.

Does it replace the CS-Cart promotions?

No. It adds conditions and bonuses to the core cart promotions. Coupons, dates, priorities, user groups and Stop other rules stay as they are.

Why is there an order discount of $0.01?

A discount that does not split evenly over the units of a line leaves a cent or two. With Exact order total it goes into the order discount so the total is exact. Choose Round per unit if you prefer no such line.

Can a customer stack a coupon with a Buy X get Y offer?

Yes, unless the promotion uses Stop other rules. The coupon’s order discount is calculated on the already discounted subtotal.

Are taxes calculated on the discounted price?

Yes, in both tax calculation methods. The discount is part of the line price, like a core product discount.

Run the deals shoppers know from big retailers

The product page has the full documentation, screenshots and the changelog.

Kavio Labs

Also by Kavio Labs

The same standards, the same support desk and one licence portal on every platform we build for.