Skip to content

Black Friday: up to 40% off Pro, yearly or lifetime.

Get the deal
Menu
Download free

Quantity rules and the bulk order form

Minimum, maximum and pack-size rules, where they are enforced, and how the bulk order form and quick order by SKU work.

Minimum, maximum and pack sizes

Pricing → Order quantities sets, per product:

  • a minimum quantity,
  • a maximum quantity,
  • a step (pack size) — the product is sold in multiples of this number.

Group-specific rules beat rules that apply to everyone, and a rule on a variation beats one on its parent. Pro adds category-scoped rules and order-value rules.

Messages name the product and a quantity that works — “sold in packs of 6, try 18” — rather than just rejecting the order.

Where they are enforced

  • The product page and the shop archive (minimum shown on the add-to-cart button)
  • The classic add-to-cart handler
  • The block cart and checkout, through the Store API
  • The cart and checkout re-check, so an old session cannot slip through
  • The bulk order form, per line

Free gifts added by a buy-X-get-Y promotion are exempt: a two-unit gift never trips a minimum of ten.

The bulk order form

Put [smb2b_bulk_order] on a page, or use the block. Assets only load on pages that actually render it.

The form is framework-free JavaScript — under 5 KB — because your shoppers should not download a SPA to place an order. It offers search with pagination, quantity inputs that clamp to the min/max/step rules, quantities that persist as buyers page and search, and a single add-everything request.

Quick order by SKU or CSV

The second tab accepts a list of SKUs and quantities, or pasted CSV. Each line reports its own status: added, not found, unavailable, or an invalid quantity. Bad lines are skipped; the rest still go in.

Reorder

Approved trade buyers get an Order again button on past orders in My Account. Items are re-added at today’s prices, with quantities clamped to the nearest valid value under the current rules.

Was this page missing something?

Documentation gaps are treated as bugs here.Tell us

Moving from another B2B plugin?

50% off

The free importer brings your customer groups, prices and approved buyers across, and shows you a dry run first. The code works if you're switching from WholesaleX, B2BKing, Wholesale Suite or Wholesale Payments.

MIGRATION50

Enter the code at checkout.