Max Quantity per Package


Overview

The Max Qty per Package is a product-level Shipping Preference setting that you can configure for regular SKUs and for Kit Products. This setting determines:

  • How many units can be shipped in a single package
  • How many shipping packages will be generated for orders
  • How many labels will be printed when shipping orders

For example, let’s say you ship an order for 4 units of a product:

  • If the product’s Max Qty per Package is 1:
    • Units per package: 1
    • Total number of packages: 4
    • Labels printed with separate tracking numbers: 4
  • If the product’s Max Qty per Package is 2:
    • Units per package: 2
    • Total number of packages: 2
    • Labels printed with separate tracking numbers: 2

Configure Regular Products

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

Manually

  1. Go to a Product Details Page.
  2. Click Toolbox and select Shipping Preferences.
  3. Click Edit.
  4. In the Packaging panel, check Enable next to Max Qty per Package.
  5. Enter the Maximum Qty Per Package value.
  6. Click Save.

In Bulk

Follow the steps to Update Products in Bulk and use the following column headers in your template:

  • MaxQtyPerShippingPackageEnabled: Set to TRUE to enable the setting.
  • MaxQtyPerShippingPackage: Set the maximum quantity per package.

Configure Kit SKUs

Setting the maximum quantity per package only works for All Component and Main Component kits. You can’t ship Independent kits in multiple packages.

The following four kit product settings are related to the Max Qty per Package:

1 – Enable Detailed Shipping Packages: An app setting that enables a more detailed shipping packages view when looking at orders. Contact Sellercloud Support to enable it.

2Number of Packages: A Shipping Preferences option where you create packages and assign components to them. For example:

  • Let’s say a kit has 2 components, and the shipping preferences include 2 packages.
  • You can assign 1 component to the main package and 1 component to a second package. 
  • If an order for that kit comes in, 2 packages will be generated. 

However, this setting only generates according to SKU, regardless of the order quantity of each SKU:

  • If an order for 2 kits comes in, the package quantity would still be 2. 
  • The 2 units of each component would be in their own separate package, generating 2 packages. 

3 – 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 Client Setting is disabled, extra packages will be created for kit components.

4 – 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.

Let’s take the following kit as an example:

  • SKU A: Table (Kit parent)
  • SKU B: Table base (Kit component)
  • SKU C: Table leg (Kit component)

The kit parent (SKU A) needs 1 base (SKU B) and 4 legs (SKU C):

  • SKU A: Qty = 1
  • SKU B: Qty = 1
  • SKU C: Qty = 4

Without the Enable Max Qty in One Package for Order Kit Items Client Setting enabled, the whole kit would go under one package. With this setting enabled, you can split the components into packages with the Max Qty field. For this example, let’s say that:

  • SKU B: Max Qty = 1
  • SKU C: Max Qty = 2

With these Max Qty settings, SKU B will be in one package. SKU C will be separated into two additional packages because the quantity ordered is 4, and the max quantity is 2. The final result:

Package 1

  • SKU A
  • SKU B: Qty = 1

Package 2

  • SKU A 
  • SKU C: Qty = 2

Package 3

  • SKU A 
  • SKU C: Qty = 2

When a kit order is placed, that order is for the kit parent SKU. The kit parent (SKU A) is in each package only for tracking purposes. To avoid errors, Sellercloud submits the kit parent SKU in the tracking upload so that it appears under the shipping packages.

Manually

To configure kits one at a time:

  1. Go to a kit parent’s Product Details Page.
  2. Click Toolbox and select Shipping Preferences.
  3. Click Edit.
  4. In the Packaging panel, check Enable next to Max Qty per Package.
  5. Enter the Maximum Qty Per Package value for the whole kit. 
    1. This value has a higher priority and overrides the Max Qty per package for components you can configure in the Components panel as described below. Even if the Max Qty set in the Components panel allows more components to be shipped in a specific package, if the Maximum Qty Per Package for the whole kit is reached for that same package, the extra component quantities will be placed in a new package.
  6. To change the Number of Packages, in the Packages panel, click the Plus icon.
  7. Enter package Weight and Dimensions. You can delete packages with the Trash icon.
  8. 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.
  9. Click Save.

In Bulk

To configure kits in bulk:

  1. Go to Catalog > Tools > Import Product Info
  2. Select Import Kits
  3. Click the Download icon to download the template.
  4. Update the column header MaxQtyPerPackage.
  5. Complete the rest of the fields and save the updated template file.
  6. Return to Sellercloud and click File to select the updated template file.
  7. Click Import.

Understanding Max Qty per Package

Enabling the Max Qty per Package setting lets you set how many items are allowed in a shipping package, and therefore, how many shipping packages will be generated for the order. You can set this for regular SKUs and for kits.

When enabled, Max Qty per Package also determines how many labels are printed when shipping an order. For example:

  • Max Qty per Package is set to 1: This means that the maximum qty allowed per package is 1. If you have an order of 4 units, then 4 labels with separate tracking numbers will be printed.  1 unit will go into each package and there will be 4 packages total.
  • Max Qty per Package is set to 2: This means that the maximum qty allowed per package is 2. If you have an order of 4 units, then 2 labels with separate tracking numbers will be printed.  2 units will go into each package and there will be 2 packages total.
The steps to configure this setting are different in the Alpha and Delta interface. When reading each section, make sure to click the appropriate interface accordion to view the correct steps.

Setting Max Qty per Package for a SKU

It is important to remember this selection not only decides how many units are allowed per package, but also decides how many labels are printed (see example above).

You can easily bulk-update multiple products as follows:
1) Use the column header MaxQtyPerShippingPackageEnabled (set to TRUE) to enable that setting in those products.
2) Use the column header MaxQtyPerShippingPackage and set it to the desired quantity value for those products.
  1. Go to Inventory > Select your product.
  2. Navigate to the Toolbox > Shipping Preferences.
  3. Check Max Qty per Package Enabled to enable the Max Qty per Package setting. The Max Qty per Package field appears below.
  4. Enter the maximum quantity per package value > Save Preferencesalpha max qty per package

Setting Max Qty per Package for a kit

This option only works for All Component and Main Component kits. Independent kits cannot be shipped in multiple packages..

In addition to the Max Qty per Package, kits have another package configuration, Number of Packages. This lets you set the number of packages needed for shipping this kit and assign the components to a package.

For example, if a Kit ABC is composed of 2 components, you can create 2 packages. Then, you can assign 1 component to the main package and 1 component to a second package. When an order for Kit ABC comes in, 2 packages will be generated.

However, this setting only generates according to SKU, regardless of order qty of each SKU. For example, if 2 of Kit ABC is ordered, then the package qty would still be 2. Now, the 2 units of each component would be in their own separate package, generating 2 packages. To separate packages for each individual unit, click the appropriate accordion for directions.

  1. Go to Inventory and choose your kit.
  2. Toolbox > Shipping Preferences.
  3. Check the Max Qty per Package Enabled setting. The Max Qty per Package field appears > Enter your value.
  4. Enter your Number of Packages and the page will refresh with the correct package numbers below.
  5. Select your Shipping Package from the dropdown menu for each SKU. Then, set the Max Qty per SKU.
  6. Save Preferences. max qty per package kit

You can also import this information in bulk and filling out the column header MaxQtyPerPackage.

Go to Inventory > Import Product Info > Import Kits. Show me a where.

Understanding kit settings

There are two kits settings that are relevant to Max Qty per Package.

  • Enable Detailed Shipping Packages View: This is an app setting that will change the view of shipping packages on an order level. When enabled, you will see a more detailed view.
    You can confirm if the app setting Enable Detailed Shipping packages is enabled by contacting Sellercloud Support.
  • Do Not Create Extra Packages For Kit Components With Max Qty: When enabled, this setting will not create extra packages for kits. When disabled, extra packages will be created. This is a client setting and it is further explained below.

When the client setting Do Not Create Extra Packages For Kit Components With Max Qty is enabled, you will see your kit components shipping preferences. You can set the Max Qty for each component from the kit’s parent Shipping Preferences page.

When Client Setting Enable Max Qty in one Package for Order Kit items is enabled, the field Max Qty will display for kit components under the Shipping Preferences page of the kit parent. Filling out the Max Qty field will ensure that the kit components are distributed in separate packages automatically.

For example, let’s look at the following kit:

  • SKU A: table, kit parent
  • SKU B: base of table, kit component
  • SKU C: leg of table, kit component

A kit parent (SKU A) needs 1 base (SKU B) and 4 legs (SKU C).

  • SKU A: Qty = 1
  • SKU B: Qty = 1
  • SKU C: Qty = 4
Without this client setting enabled, the whole kit would go under one package. See the definition above.

With the above client setting enabled, we can split the components into packages. You will need to set the Max Qty field.

  • SKU B: Max qty = 1
  • SKU C: Max qty = 2

With this example, SKU B will be in one package. SKU C will be separated into two additional packages  because the qty ordered is 4 and the max qty is 2. The final results would look like:

PACKAGE PACKAGE CONTENTS
Package 1
  • SKU A 
  • SKU B: Qty = 1
Package 2
  • SKU A 
  • SKU C:  Qty = 2
Package 3
  • SKU A 
  • SKU C: Qty = 2
The reason the kit parent (SKU A) is shown under the package is for tracking purposes only. When a customer places an order, they order the actual kit parent, so this is the SKU that comes with the order. To avoid any errors with the channels, we must submit that same kit parent SKU in the tracking upload, so it will be present under the shipping packages.

Was this article helpful?

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