Quantity Increments, Packaging and Decimal Quantity
Configure global and per-product quantity increments, package ordering, decimal quantities, and CSV import settings.
Configure quantity increments, packaging, and decimal quantities so customers can order products in the quantities you sell.
Quantity increments restrict purchases to specified steps. Packaging lets customers enter a number of packages instead of individual units. Decimal Quantity allows quantities such as 0.5.
How to Configure Quantity Increments
Set default quantity increments at the global level, then customize individual product settings as needed.
Global Qty Increment Settings
Configure the default quantity increment for all products.
Set the global quantity increment
- Go to Products > Settings > Inventory.
- Enable Quantity Increments for all products and set the global increment.
Optional: Allow Admins to ignore quantity increments
Go to Orders > Settings > Admin Create Orders and set Enforce Increment Stepping When Adjusting Qty to No. Admins can then enter any item quantity when creating an order, even when the storefront enforces an increment.
This setting applies globally; you cannot configure it separately for each product.
Product-Specific Qty Increment Settings
Override the global increment for an individual product. After saving the product, you can also set different increments for different customer groups.
Configure a product
- Open the product's edit screen and find Inventory & Shipping.
- Click Configure Qty Increments.
- Enable Quantity Increments and set the increment for the product.
- Save the product. To use different increments for different customer groups, set their values after saving.
Optional: Enable packaging
Packaging lets customers order by package count rather than unit count. If a case contains 12 units, a customer can enter 1 case to order 12 units.
- Open the product's Quantity Increments settings and set Enable Packaging to Yes.
- Enter the package settings:
| Setting | What to enter |
|---|---|
| Unit Label | Name for one unit, such as Bottle(s). |
| Quantity Increment | Number of units per package, such as 12 for a case of 12 bottles. |
| Package Label | Name of the package, such as Case, Pallet, or Crate. |
Where customers and Admins see packaging
The package quantity appears on the product page:
On the category page:
In the shopping cart:
And in the Admin Order Create and Quote Create screens:
Packaging does not work well with complex product types such as Bundle and Group, and it does not work with Quick Order.
Optional: Allow decimal quantities
Enable Decimal Quantity for a product when customers need to order less than one unit, such as 0.5. Configure this on each product that needs decimal quantities.
Optional: Update quantity settings by CSV
Use a product CSV file to update quantity increments, decimal quantities, and packaging in bulk. Include the product SKU and the headers for the settings you want to update.
| CSV header | Value |
|---|---|
sku | Product SKU. |
qty | Available product quantity. |
is_qty_decimal | 1 = Yes; 0 = No. Allows decimal quantities. |
use_config_qty_increments | 1 = use the global quantity increment from Products > Settings; 0 = use the product's quantity increment. See Inventory Management. |
qty_increments | Numeric increment, such as 0.125 when Decimal Quantity is enabled or 5 when it is disabled. |
enable_qty_increments | 1 = Yes; 0 = No. When set to 1, set use_config_qty_increments to 0 to use the product setting instead of the global increment. |
use_config_enable_quantity_inc | 1 = Yes; 0 = No. When set to 1, the existing CSV instructions also require use_config_qty_increments to be 0. |
enable_qty_packaging | Yes or No. Enables packaging. |
qty_increment_label | Package label, such as Cases. |
qty_unit_label | Unit label, such as Bottles. |
- Save the CSV file with the headers and values for your products.
- Go to Advanced > Import & Export > Import and import the CSV file.
- If the changes do not appear, Index and Refresh your store.
On a Mac, save the file as Windows Comma Separated. Other CSV formats may be rejected by the import system.
Updated 16 days ago