Searching...

Max Quantity per Package

Overview

The Max Qty per Package is a product-level Shipping Preference that determines the maximum number of units that can be packed together in a single package. This setting directly controls how many packages an order generates and how many shipping labels are produced. It is available for both standalone SKUs and Kit Products, allowing you to apply consistent packaging rules across your catalog.

Max Qty per Package for Products

When an order contains multiple units of a product, the number of packages and shipping labels depends on the product’s Max Qty per Package. For example, if the product’s Max Qty per Package is 1, each ordered unit will be packed and shipped separately, resulting in multiple packages and individual tracking labels for the same order. If the Max Qty per Package is higher, the units are packed accordingly, reducing the total number of packages and tracking labels needed.

You can set the Max Qty per Package manually, one product at a time, or for multiple products in bulk.

Individually

To configure a product’s Max Qty per Package:

  1. Navigate to the Product Details Page.
  2. From the Toolbox, select Shipping Preferences.
  3. Click Edit.
  4. In the Packaging panel, check Enable and enter the Maximum Qty Per Package value.
  5. Click Save.

In Bulk

To update multiple products in bulk:

  1. Navigate to Catalog > Tools > Import Product Info > Bulk Product Update.
  2. Click Generate Template, select Create New Template, and click Next.
  3. From the Choose Format dropdown, select the file’s format (either TAB Delimited, CSV, or Excel), and click Next.
  4. Add the following column headers to your template:
    • MaxQtyPerShippingPackageEnabled – Set to TRUE to enable the setting.
    • MaxQtyPerShippingPackage – Set the maximum quantity per package.
  5. Download the template on your computer, populate the necessary information, and save the file.
  6. Return to the Bulk Product Update panel and upload the prepared file. A Queued Job will be generated, and once it’s completed, the updates will be done.

Max Qty per Package for Kits

Kit packaging is determined by its Max Qty per Package and its Number of Packages settings. If neither is defined, all kit items ship in a single package. If a Max Qty is set for the parent and the ordered quantity is greater, the system divides the parent SKU across multiple packages. When different package assignments are defined for individual components, Sellercloud packages those components separately.

To control components packaging, ensure that both the Enable Max Qty in One Package for Order Kit Items and the Do Not Create Extra Packages For Kit Components With Max Qty settings are enabled. This will allow you to specify a max qty for the components on the Parent’s Shipping Preferences page. Max Qty values on the component’s individual Shipping Preferences page will not be used and should not be configured.

Setting the maximum quantity per package is only applicable to All Component and Main Component kits. You cannot ship Independent kits in multiple packages.

You can set kits’ Max Qty per Package both individually and in bulk.

Individually

To configure an individual kit’s Max Qty per Package:

  1. Navigate to a kit parent’s Product Details Page.
  2. From the Toolbox, select Shipping Preferences.
  3. Click Edit.
  4. In the Packaging panel, check Enable and enter the Max Qty Per Package value for the whole kit. 
  5. Specify the kit’s Number of Packages.
  6. In the Packages panel, enter each package’ Weight and Dimensions. You can delete packages with the Trash icon and add more rows with the Plus icon.
  7. In the Components panel, for each kit component:
      1. Select Shipping Package from the dropdown menu.
      2. Enter the Max Qty per package. If you don’t see this option, enable the Client Setting Enable Max Qty in One Package for Order Kit Items.

  8. Click Save.

In Bulk

To configure kits in bulk:

  1. Navigate to Catalog > Tools > Import Product Info and select Import Kits.
  2. Click the Download icon to download the template.
  3. Update the column header MaxQtyPerPackage.
  4. Complete the rest of the required fields and save the updated file.
  5. Return to the Import Kits panel and click File to select the updated template file.
  6. Click Import. A Queued Job will be generated, and once it’s completed, the updates will be done.
Setting Definition 
Enable Max Qty in One Package for Order Kit Items A Client Setting that enables the Max Qty option for kit components under the Shipping Preferences page of the kit parent. Setting the Max Qty ensures that the kit components will be distributed in separate packages automatically.
Do Not Create Extra Packages For Kit Components With Max Qty A Client Setting that prevents the creation of extra packages for kit components with the Max Qty option configured on the kit parent’s Shipping Preferences page. When this setting is disabled, extra packages will be created for kit components. Enabled by default. 
EnableDetailedShippingPackages An app setting that enables a more detailed shipping packages view when looking at orders. Open a ticket with Sellercloud Support to enable it.
EnableMoveKitParentOnlyPackageToSubPackage An app setting that moves the kit parent out of a standalone package and into a package that already contains a kit component or another regular item. Its purpose is to prevent the kit parent from generating an unnecessary extra package on the order. Open a ticket with Sellercloud Support to enable it.
Tagged:

Was this article helpful?

Yes No
Need Support?
Can't find the answer you're looking for?
Contact Support