Configuring Minimum Order Batch for Product in 1C-Bitrix
A minimum order batch is a restriction where a buyer cannot purchase a product in a quantity less than the set value. In Bitrix, this is implemented at the catalog properties level, not the cart: the MIN_QUANTITY field in the b_catalog_product table.
Where It's Stored and How It Works
Each product in the Bitrix catalog has a record in b_catalog_product, where in addition to price and stock levels are stored:
-
MIN_QUANTITY— minimum quantity for order -
STEP_QUANTITY— quantity change step (multiplicity, separate setting)
When adding a product to cart, the catalog module checks MIN_QUANTITY. If the buyer specified less — the quantity is automatically raised to the minimum, or an error is displayed (depends on component settings).
Configuration via Admin Interface
Catalog → [select product] → Trade Offers/Quantity:
Field "Minimum order quantity" — enter a whole number. Value 0 or 1 means no restriction.
For bulk assignment of minimum batch, use import via CSV or XML (Catalog → Import), where in the MIN_QUANTITY column you specify the needed value for each position.
Configuration via API
For programmatic setup via CIBlockElement::SetPropertyValues or via \Bitrix\Catalog\Model\Product::update:
\Bitrix\Catalog\Model\Product::update($elementId, [
'MIN_QUANTITY' => 10,
]);
Display in Cart Component
The standard bitrix:sale.basket.basket component (and bitrix:catalog.element) reads MIN_QUANTITY and when attempting to decrease quantity below the minimum, returns the quantity to the allowed level. If using a custom component or headless frontend, this behavior must be implemented separately — read MIN_QUANTITY from the catalog API and validate on the client.
Combination with Multiplicity
If both minimum batch and multiplicity (STEP_QUANTITY) are set, the minimum quantity should be a multiple of the step. For example, MIN_QUANTITY = 6, STEP_QUANTITY = 3 — correct. MIN_QUANTITY = 5, STEP_QUANTITY = 3 — will lead to incorrect cart behavior. This consistency must be controlled when filling in data.
Timelines
Setting minimum batch for individual products or bulk via import — 2–4 hours, including checking display in cart components.