# Configure recommended packaging from item dimensions
URL: https://support.starshipit.com/articles/8753012178447-configure-recommended-packaging-from-item-dimensions
Canonical: https://support.starshipit.com/articles/8753012178447-configure-recommended-packaging-from-item-dimensions
Markdown: https://support.starshipit.com/articles/8753012178447-configure-recommended-packaging-from-item-dimensions.md
Updated: 2026-11-12

> For the complete documentation index, see [llms.txt](https://support.starshipit.com/llms.txt).

> Choose saved packages using item dimensions, then review the suggested items in each package from order details.

Use Recommended Packaging to select saved boxes or satchels based on the dimensions of the items in an order. After import, review the suggested items in each package using **Contents** in order details.

:::note
Recommended Packaging uses item and package dimensions. It does not use the minimum and maximum weight ranges on your saved packages.
:::

{{video:youtube:IaCbkQUnwQk}}

## How it works

Here's how this algorithm would package an order:

* The algorithm first examines the dimensions of each item in an order, using data from your Product Catalogue or the order's import details. For Shopify, imported order details can include configured Product or Product Variant dimension metafields.
* To start, the algorithm will try and pack all items in the order into a single package. If there are multiple packages that could be used, the algorithm will select the package with the least amount of empty space after the items have been packed.
* If not all items will fit into one package, the algorithm will pack as many items as possible into the first package, and then select another package for the remaining items. It will repeat this process until all items are packed.
* The chosen package names, dimensions and weights are applied to the imported order.

## Set up

1. Ensure you have [set up your packages](/articles/orders-manifests-reports/orders/set-up-packages-and-import-weights-and-dimensions) with the correct dimensions in your Starshipit account.
2. Confirm that your product imports include item dimensions. You can use the [Product Catalogue](/articles/integrations/product-catalogue/product-catalogue), or for Shopify imported orders, [product dimensions metafields](/articles/integrations/shopify/shopify-import-optional-data#product-dimensions-metafields).
3. Navigate to **Settings** > **Packaging** > **Weight of Packaging** in your Starshipit account. Choose 'Automatically assign packages based on item dimensions' from the dropdown menu

The setting applies when orders import. Saving it does not immediately recalculate existing orders. Follow [Remove and re-import orders](/articles/360000118196-remove-and-re-import-orders) if you need to import an existing order again.

## Check the recommended package contents

In UI 2.0, use **Contents** to review the suggested item breakdown after an order imports with Recommended Packaging.

The suggested item-to-package breakdown is packing guidance and isn't sent to couriers. Package weights, dimensions and other shipment details still follow the normal courier workflow.

1. Open the imported order from **[Orders](https://next.starshipit.com/orders)**.
2. Expand **Packaging**.
3. Select **Contents** from the **View** menu to see the items and quantities suggested for each package.
4. Compare the suggested arrangement, package dimensions and weights with how you will physically pack the order before printing its shipping labels.

If you have saved your own item assignments, Contents shows those instead of the suggestion. Complete saved assignments can be used for package-level customs contents on multi-package Australia Post Global Logistics shipments. See [View and edit items in packages](/articles/1794481200000-view-and-edit-items-in-packages) for how to edit, save and print contents, and how saved assignments affect courier customs information.

## A note on item dimensions

To use this packaging feature, Starshipit requires dimensions for each of your items. You can use Starshipit's Product Catalogue, or a supported integration source such as Shopify dimension metafields on imported orders.

Integrated platforms which support item details:

* WooCommerce
* Magento
* Magento2 – [Read our guide](/articles/integrations/ecommerce-platforms/how-to-set-up-product-dimensions-in-magento-2)
* Cin7 Core
* Cin7 Omni
* Brightpearl
* Shopify, when product dimensions metafields are configured for imported orders
* Neto, when **Import additional product information** is enabled in the integration settings
* Unleashed, when **Import product details** is enabled and the product dimensions unit is configured
* PrestaShop, which imports product width, height and depth when those values are present in the product data
