Skip to content

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 comes back with its own status — added, not found, unavailable, or an invalid quantity — so one bad line never fails the whole order.

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 →