{"id":383648,"date":"2026-10-15T10:59:51","date_gmt":"2026-10-15T10:59:51","guid":{"rendered":"https:\/\/wordpress.org\/plugins\/kosslabs-cart-limits\/"},"modified":"2026-10-15T12:38:11","modified_gmt":"2026-10-15T12:38:11","slug":"kosslabs-cart-limits","status":"publish","type":"plugin","link":"https:\/\/wordpress.org\/plugins\/kosslabs-cart-limits\/","author":14651540,"comment_status":"closed","ping_status":"closed","template":"","meta":{"version":"1.0.1","stable_tag":"1.0.1","tested":"7.1.3","requires":"6.2","requires_php":"7.4","requires_plugins":null,"header_name":"KossLabs Cart Limits","header_author":"KossLabs","header_description":"Ultra-lightweight minimum order quantity & cart amount limits for WooCommerce. 100% Cart & Checkout Blocks, Store API & HPOS compatible.","assets_banners_color":"1d3142","last_updated":"2026-10-15 12:38:11","external_support_url":"","external_repository_url":"","donate_link":"https:\/\/profiles.wordpress.org\/theaikoss","header_plugin_uri":"https:\/\/wordpress.org\/plugins\/kosslabs-cart-limits\/","header_author_uri":"https:\/\/profiles.wordpress.org\/theaikoss","rating":0,"author_block_rating":0,"active_installs":0,"downloads":52,"num_ratings":0,"support_threads":0,"support_threads_resolved":0,"author_block_count":0,"sections":["description","installation","faq","changelog"],"tags":{"1.0.0":{"tag":"1.0.0","author":"theaikoss","date":"2026-10-15 10:59:32","revision":3748241},"1.0.1":{"tag":"1.0.1","author":"theaikoss","date":"2026-10-15 12:38:11","revision":3748479}},"upgrade_notice":[],"ratings":[],"assets_icons":{"icon-128x128.png":{"filename":"icon-128x128.png","revision":3748448,"resolution":"128x128","location":"assets","locale":"","width":128,"height":128},"icon-256x256.png":{"filename":"icon-256x256.png","revision":3748448,"resolution":"256x256","location":"assets","locale":"","width":256,"height":256}},"assets_banners":{"banner-1544x500.png":{"filename":"banner-1544x500.png","revision":3748448,"resolution":"1544x500","location":"assets","locale":"","width":1544,"height":500},"banner-772x250.png":{"filename":"banner-772x250.png","revision":3748448,"resolution":"772x250","location":"assets","locale":"","width":772,"height":250}},"assets_blueprints":{},"all_blocks":[],"tagged_versions":["1.0.0","1.0.1"],"block_files":[],"assets_screenshots":[],"screenshots":{"1":"Store-wide Cart Rules settings under WooCommerce Settings.","2":"Product-level minimum and maximum quantity settings in the Inventory tab.","3":"Native Store API Checkout Block notice with real-time difference calculation.","4":"Drawer cart and shop loop protection with automatic quantity adjustment."}},"plugin_section":[],"plugin_tags":[230374,177616,270329,286924,75765],"plugin_category":[],"plugin_contributors":[284505],"plugin_business_model":[],"class_list":["post-383648","plugin","type-plugin","status-publish","hentry","plugin_tags-cart-limits","plugin_tags-minimum-order-quantity","plugin_tags-order-limits","plugin_tags-store-api","plugin_tags-woocommerce-limits","plugin_contributors-theaikoss","plugin_committers-theaikoss"],"banners":{"banner":"https:\/\/ps.w.org\/kosslabs-cart-limits\/assets\/banner-772x250.png?rev=3748448","banner_2x":"https:\/\/ps.w.org\/kosslabs-cart-limits\/assets\/banner-1544x500.png?rev=3748448","banner_rtl":false,"banner_2x_rtl":false},"icons":{"svg":false,"icon":"https:\/\/ps.w.org\/kosslabs-cart-limits\/assets\/icon-128x128.png?rev=3748448","icon_2x":"https:\/\/ps.w.org\/kosslabs-cart-limits\/assets\/icon-256x256.png?rev=3748448","generated":false},"screenshots":[],"raw_content":"<!--section=description-->\n<p><strong>KossLabs Cart Limits<\/strong> is a modern, ultra-lightweight order limits engine engineered specifically for modern WooCommerce stores. It is built from the ground up to support the new React-based <strong>Cart &amp; Checkout Blocks<\/strong>, the official WooCommerce <strong>Store API<\/strong>, and High-Performance Order Storage (<strong>HPOS<\/strong>).<\/p>\n\n<p>Whether you run a B2B wholesale store requiring minimum purchase thresholds or a retail store preventing unprofitable micro-orders, KossLabs Cart Limits provides frictionless limits without slowing down your website.<\/p>\n\n<h3>\ud83d\ude80 Key Technical Differentiators<\/h3>\n\n<ul>\n<li><strong>Dual-Engine Validation (Store API + Classic):<\/strong> Complete protection across traditional checkout and modern Gutenberg React Cart\/Checkout blocks (<code>\/wp-json\/wc\/store\/v1\/cart<\/code>). Customers cannot bypass rules by switching checkout layouts.<\/li>\n<li><strong>Smart Difference Engine (CRO-Driven Notices):<\/strong> Instead of cold, frustrating error messages, CartRules displays encouraging, conversion-focused notices with real-time mathematical calculations:\n\n<ul>\n<li><code>{min_amount}<\/code>, <code>{current_amount}<\/code>, <code>{needed_amount}<\/code> (exact missing money to checkout)<\/li>\n<li><code>{min_qty}<\/code>, <code>{current_qty}<\/code>, <code>{needed_qty}<\/code> (remaining quantity needed)<\/li>\n<li><code>{product_title}<\/code>, <code>{max_qty}<\/code>, <code>{excess_qty}<\/code><\/li>\n<\/ul><\/li>\n<li><strong>Intelligent Stock Management (Allow Remaining Stock):<\/strong> If your remaining stock is lower than your minimum order threshold (e.g. 2 units left in stock but minimum is 5), CartRules automatically adjusts the threshold so your last inventory does not get stranded unsold.<\/li>\n<li><strong>Auto-Bump Loop Integration:<\/strong> When customers click \"Add to Cart\" directly from archive\/shop loops, the system automatically adds the minimum required quantity instead of locking them in an error loop.<\/li>\n<li><strong>Zero-Bloat &amp; HPOS Native:<\/strong> Zero custom SQL database tables. Zero jQuery dependency (&lt; 3 KB pure Vanilla JS). Full Redis, Varnish, and LiteSpeed cache compatibility.<\/li>\n<\/ul>\n\n<h3>\ud83c\udf1f Free Features (Core)<\/h3>\n\n<ul>\n<li>Set minimum order quantity per individual product.<\/li>\n<li>Set maximum order quantity per individual product.<\/li>\n<li>Enforce store-wide minimum cart amount.<\/li>\n<li>Choose amount calculation basis: Subtotal (Excl. Tax - ideal for B2B), Subtotal (Incl. Tax), Cart Contents Total, or Grand Total.<\/li>\n<li>Enforce store-wide minimum total items quantity across the entire cart.<\/li>\n<li>Full protection across Single Product, Shop Archives, Drawer\/Mini-Carts, Cart, and Checkout Blocks.<\/li>\n<li>100% translatable with clean internationalization standards (<code>.pot<\/code> included).<\/li>\n<\/ul>\n\n<h3>\ud83d\udc8e Advanced PRO Features<\/h3>\n\n<p>Need enterprise B2B capabilities? KossLabs Cart Limits PRO adds:<\/p>\n\n<ul>\n<li><strong>B2B &amp; User Role-Based Limits:<\/strong> Define separate cart thresholds for Wholesalers ($500) vs Retail customers ($30).<\/li>\n<li><strong>Category-Specific Limits:<\/strong> Enforce unique order thresholds based on product categories.<\/li>\n<li><strong>Dynamic Cart Progress Bar:<\/strong> Visual progress tracker in cart blocks (\"Add $15 more for free shipping!\").<\/li>\n<li><strong>Tiered Cart Notices:<\/strong> Multi-tiered encouragement for higher order values.<\/li>\n<\/ul>\n\n<!--section=installation-->\n<ol>\n<li>Upload the <code>kosslabs-cart-limits<\/code> folder to your <code>\/wp-content\/plugins\/<\/code> directory, or install directly via the WordPress Plugins menu.<\/li>\n<li>Activate the plugin through the 'Plugins' menu in WordPress.<\/li>\n<li>Ensure WooCommerce is installed and active.<\/li>\n<li>Navigate to <strong>WooCommerce &gt; Settings &gt; Cart Rules<\/strong> to configure store-wide thresholds and notice templates.<\/li>\n<li>To set product-specific limits, edit any product and navigate to the <strong>Product Data &gt; Inventory<\/strong> tab.<\/li>\n<\/ol>\n\n<!--section=faq-->\n<dl>\n<dt id=\"does%20this%20plugin%20work%20with%20the%20new%20woocommerce%20cart%20and%20checkout%20blocks%3F\"><h3>Does this plugin work with the new WooCommerce Cart and Checkout Blocks?<\/h3><\/dt>\n<dd><p>Yes! 100%. CartRules hooks directly into the official WooCommerce Store API (<code>woocommerce_store_api_cart_errors<\/code>). When a limit is violated, the Checkout Block is immediately locked with a native, seamless alert banner.<\/p><\/dd>\n<dt id=\"does%20this%20plugin%20slow%20down%20my%20store%3F\"><h3>Does this plugin slow down my store?<\/h3><\/dt>\n<dd><p>Not at all. The frontend script is written in pure Vanilla JavaScript and weighs less than 3 KB. It loads conditionally only on shop, product, cart, and checkout pages. Zero external libraries, zero custom database tables.<\/p><\/dd>\n<dt id=\"what%20happens%20if%20i%20have%20only%202%20items%20left%20in%20stock%20but%20the%20minimum%20order%20quantity%20is%205%3F\"><h3>What happens if I have only 2 items left in stock but the minimum order quantity is 5?<\/h3><\/dt>\n<dd><p>With our \"Allow Remaining Stock\" feature enabled, CartRules automatically lowers the minimum requirement to the remaining stock (2) so you can sell out your inventory without getting stuck.<\/p><\/dd>\n<dt id=\"can%20i%20customize%20the%20notice%20messages%3F\"><h3>Can I customize the notice messages?<\/h3><\/dt>\n<dd><p>Yes. In <strong>WooCommerce &gt; Settings &gt; Cart Rules<\/strong>, you can customize all notification templates using dynamic tags like <code>{min_amount}<\/code>, <code>{needed_amount}<\/code>, <code>{min_qty}<\/code>, and <code>{needed_qty}<\/code>.<\/p><\/dd>\n\n<\/dl>\n\n<!--section=changelog-->\n<h4>1.0.1<\/h4>\n\n<ul>\n<li>Connected official Freemius PRO upgrade checkout link.<\/li>\n<li>Added direct Settings and Upgrade action links in plugins list.<\/li>\n<\/ul>\n\n<h4>1.0.0<\/h4>\n\n<ul>\n<li>Initial public release.<\/li>\n<li>Added Store API and Gutenberg Checkout Blocks validation.<\/li>\n<li>Added Smart Difference Engine with dynamic placeholder tags (<code>{needed_amount}<\/code>, <code>{needed_qty}<\/code>).<\/li>\n<li>Added intelligent remaining stock fallback.<\/li>\n<li>Added Auto-Bump loop add-to-cart integration.<\/li>\n<li>Full HPOS (High-Performance Order Storage) declaration.<\/li>\n<\/ul>","raw_excerpt":"Ultra-lightweight, zero-bloat minimum order quantity, cart amount thresholds &amp; smart CRO limits for WooCommerce. 100% Store API &amp; Blocks ready.","jetpack_sharing_enabled":true,"_links":{"self":[{"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin\/383648","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin"}],"about":[{"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/types\/plugin"}],"replies":[{"embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/comments?post=383648"}],"author":[{"embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wporg\/v1\/users\/theaikoss"}],"wp:attachment":[{"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/media?parent=383648"}],"wp:term":[{"taxonomy":"plugin_section","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_section?post=383648"},{"taxonomy":"plugin_tags","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_tags?post=383648"},{"taxonomy":"plugin_category","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_category?post=383648"},{"taxonomy":"plugin_contributors","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_contributors?post=383648"},{"taxonomy":"plugin_business_model","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_business_model?post=383648"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}