Min/Max Order & Quantity Rules for CS-Cart and Multi-Vendor

What it does

Quantity and order limits beyond the per-product fields of CS-Cart. Product rules set a minimum, a maximum and a case pack size for whole categories, product lists or vendors. Customer limits stop resellers on limited editions, for example 2 per customer every 30 days. Cart rules set a minimum or maximum amount, quantity or number of products, and mix-and-match multiples across a category. On Multi-Vendor every vendor can have its own minimum order. For wholesale, B2B, food and drink, drops and marketplaces.

How it works

Create rules in Products, Quantity rules

Choose the type, the categories, products or vendors, the customer groups and storefronts, and the limits. Quantity fields step by the case pack and CS-Cart corrects quantities while shopping. The cart lists unmet rules, and the checkout opens only when the cart meets them. Every rule is checked again when the order is placed, also for admin orders (warning or block) and REST API orders. Full page cache safe.

Features

Case packs, minimum and maximum quantity per line by category, product or vendor
Purchase limits per customer and period, by account or e-mail
Cart minimum and maximum amount, before or after discounts
Total quantity and different-product limits, mixed-case multiples
Minimum order per vendor, set by the admin or the vendor
Rules by customer group and storefront, with exceptions and priority
Product page notes, cart panel and per-line notes, own messages
Checked at add to cart, checkout, admin and REST API orders

What you get

Package	kv_order_quantity_rules-1.0.0.zip, installed through Add-ons → Manage add-ons
Updates & support	12 months included. Download new versions from your account and install them in Add-ons → Manage add-ons or the Upgrade Center.
License	1 production installation. Staging, dev and localhost are free and unlimited. The add-on keeps working after the update period ends. How licensing works

Compatibility

We list only the builds we install and test on. “Tested” means the full test plan was run on that build; “Supported” means the build is inside the supported range and uses the same hooks.

CS-Cart version and edition compatibility
CS-Cart version	CS-Cart	CS-Cart Ultimate	Multi-Vendor	Multi-Vendor Ultimate
4.22 and later	Testing next	Testing next	Testing next	Testing next
4.21.2	Supported	Supported	Supported	Supported
4.20.x	Supported	Supported	Supported	Supported
4.19.x	Supported	Supported	Supported	Supported
4.18.x	Supported	Supported	Supported	Supported
4.17.2	Supported	Supported	Tested	Supported
Before 4.17.2	Not supported	Not supported	Not supported	Not supported

Last tested build: Multi-Vendor 4.17.2, Oct 23, 2026Tested on: Multi-Vendor 4.17.2

Requirements

Platform	CS-Cart or Multi-Vendor 4.17.2 – 4.21.x
PHP	PHP 7.2.5 – 8.3 (the range your CS-Cart version supports)
Core changes	None. Hooks and template overrides only

1.0.0

Oct 23, 2026

Latest

Added 8

Product quantity rules: minimum, maximum and "sold in multiples of" (case pack) per cart line for categories, products or vendors, combined with the product's own quantity settings; the quantity field steps by the pack size.
Customer purchase limits per period, per product or for all matching products together (customers by account, guests by e-mail).
Cart and group rules: minimum and maximum amount (before or after order discounts), total quantity, mixed-case multiples, number of different products, optionally per vendor.
Multi-Vendor: minimum order per vendor, set by the administrator or, optionally, by the vendor.
Scopes: customer groups, storefronts, product exceptions, priority; own shopper message per rule.
Product page notes, cart panel with what to add or remove, per-line notes, checkout opens only when the cart meets the rules.
Server-side checks at add to cart, cart update, checkout, place order, admin orders (warn or block) and REST API orders (HTTP 403).
Full page cache safe storefront output; domain-bound license; self-healing upgrades.

Tested on Multi-Vendor 4.17.2. First release.

How is this different from the quantity settings in the product editor?

CS-Cart has a minimum, a maximum and a step per product and one store-wide minimum order amount. The add-on applies limits to whole categories, product lists or vendors at once, by customer group and storefront, and adds what CS-Cart does not have: purchase limits per customer and period, maximum order amount and quantity, mixed-case multiples across a category, limits on the number of different products and a minimum order per vendor. The product settings keep working and are combined with the rules.

Does the add-on change my products?

No. It never writes product data. The rules are applied while shoppers add products and check out.

Can a shopper get around a rule?

No. Every rule is checked on the server when the order is placed, also for orders created through the REST API. The product page and cart messages are only there so that nobody is surprised at checkout.

Several product rules match one product. Which one applies?

The one with the lowest priority number. Cart rules and customer limits all apply.

How are guests limited by a customer purchase limit?

By the e-mail address they enter at checkout: earlier orders with that address count (setting Count guest purchases by e-mail). Before an e-mail is known, the limit applies to the cart.

Which orders count for customer purchase limits?

Every order of the customer in the period, except failed, declined, canceled and incomplete ones.

Can I place an order that breaks a rule as an administrator?

Yes, with the default setting Warn and allow: the order editor shows the unmet rules as warnings. Choose Block to forbid it.

Does it work with the full page cache of CS-Cart 4.21?

Yes. Product page notes are the same for every guest; per-customer counts are only read in the cart and at checkout, which are never cached.

Can vendors set their own minimum order?

Yes, when you switch on Vendors can set their own minimum order. Otherwise only administrators set it on the vendor page. Vendors cannot create rules.

The admin panel shows a license notice.

Open Add-ons → Manage add-ons → Min/Max Order & Quantity Rules → Settings → License. The status line says what is wrong: no key, a key for another add-on, a revoked license, or a domain that the license does not cover. Fix it and click Check now. See License.

Does the add-on work on my staging copy?

Yes. Subdomains of your licensed domain (for example staging.yourstore.com) and local development hosts (localhost, private IP addresses, .local, .test) are covered by the same license.

What happens if your license server is down?

Nothing changes for 14 days: the add-on keeps working and retries every hour. Only if no check succeeds for 14 days is it switched off until the next successful check.

Does the license check slow down my storefront or checkout?

No. The check runs in the admin panel or from cron, once a day. The storefront never runs it.

InstallationRequirements, Install, Upgrade, Disable, Uninstall ConfigurationGeneral, Rules, License UsageRule types, What shoppers see, Orders created in the admin panel, REST API orders, Multi-Vendor, Items that are never limited Developer notesHow the rules are applied, Template hooks, Data, Full page cache and block cache, Evaluating a cart in your code, File map FAQ13 answers to common questions.

Browse by category

Goals

Best seller

Min/Max Order & Quantity Rules

What it does

How it works

Create rules in Products, Quantity rules

Features

What you get

Compatibility

Requirements

Added 8

Details

Support

Frequently bought together

Also from Kavio Labs

Product Videos Gallery

Shipping Goal Progress Bar

Vendor Vacation Mode

See the roadmap