# Set up item dimensions for packaging URL: https://support.starshipit.com/articles/1792372698951-set-up-item-dimensions-for-packaging Canonical: https://support.starshipit.com/articles/1792372698951-set-up-item-dimensions-for-packaging Markdown: https://support.starshipit.com/articles/1792372698951-set-up-item-dimensions-for-packaging.md Updated: 2026-10-19 > For the complete documentation index, see [llms.txt](https://support.starshipit.com/llms.txt). > Supply item sizes through your integration or Product Catalogue, then check that imported orders have the data your packaging option needs. Give Starshipit the size of each item so it can calculate package dimensions or choose a saved package for an imported order. You can supply that data through a supported integration or store it in the Product Catalogue against each item's SKU. ## Before you begin - Record the length, width and height of **one unit** of each product, as it will go into the shipping package. Record its weight too if your packaging option uses item weights. Starshipit uses the order quantity separately. - Keep item dimensions separate from package dimensions. An item is the product being shipped; a package is the box or satchel holding one or more items. - If you use the Product Catalogue, check that your account has access and that you can edit products and catalogue settings. Add each product variant under the SKU used on imported orders. Item dimensions are needed for **Single package - Imported item weights and dimensions**, **Single package - Default package weight + imported item dimensions**, **Pack each item separately** and **Recommended Packaging - Automatically assign best-fit package**. The two options that use saved package dimensions do not need item dimensions. ## Choose where item dimensions come from If your integration supplies item dimensions, maintain the measurements there and check that all three dimensions reach Starshipit. Importing an item's weight does not mean its dimensions are also supplied. Shopify imported orders can use [product dimensions metafields](/articles/90200000000206-import-optional-data-from-shopify#product-dimensions-metafields). Adobe Commerce has its own [product-dimensions setup](/articles/5882363781647-set-up-product-dimensions-in-magento-2). Other integration support depends on its import configuration; check an imported order rather than assuming the storefront measurements are included. Use the Product Catalogue when you need Starshipit to fill missing measurements or use your shipping measurements in place of the integration's values. Products are matched by SKU. ## Store measurements in the Product Catalogue 1. Go to **Settings > Product Catalogue**. 2. Select **Add new product manually**, or find the matching SKU and select **Edit**. 3. Enter the product's SKU, length, width, height and weight, using the units shown on the form. 4. Save the product, then reopen it to check the measurements. 1. Select **Products** from the left menu. 2. Select **Add product**, or find the matching SKU and select its pencil icon to edit it. 3. Enter the product's SKU, **Length**, **Width**, **Height** and **Weight**, using the units shown beside the fields. 4. Select **Save**, then reopen the product to check the measurements. For several products, use the CSV workflow in [Add and manage products in the Product Catalogue](/articles/1781620000001-add-and-manage-products-in-the-product-catalogue). Check the template's units before uploading; they can differ from the units shown on the product form. ## Apply catalogue data during import 1. Go to **Settings > Product Catalogue**. 2. Leave **Disable the Product catalogue** unchecked in Classic UI, or **Disable the product catalogue** unchecked in UI 2.0. 3. Choose **Only populate missing values** to keep supplied item values and fill gaps, or **Override all values** to use catalogue data for matching SKUs instead. Override affects other product fields too, so check the full product record before choosing it. 4. To protect supplied values when catalogue data is incomplete, enable **Prevent populating if value is empty or 0** in Classic UI, or **Do not replace imported values with empty or zero product catalogue values** in UI 2.0. 5. Select **Save** and reopen the settings to confirm your choices. If the integration supplies complete packages, **Only populate missing values** does not fill missing item dimensions through this import path. Check the integration's package setup rather than switching to **Override all values** without reviewing its wider effect. Peoplevox has a separate import workflow; use its [package configuration guide](/articles/90200000000501-configure-peoplevox-labels-couriers-and-packages). These steps prepare imported orders. Checkout catalogue use has a separate setting; see [Configure Product Catalogue settings](/articles/1781620000002-configure-product-catalogue-settings) if you also need item data for checkout rates. ## Check an imported order 1. Import an order containing a product whose SKU and measurements you know, using your normal integration workflow. 2. Open the order and check that the item's SKU, quantity, length, width, height and weight match the values you intended to supply. Compare in the same units. 3. Check the resulting package count, dimensions and weight against your chosen [packaging option](/articles/206705413-set-up-packages-and-import-weights-and-dimensions#choose-how-packages-are-assigned), including any matching packaging rule. 4. Compare the package with the parcel you will send, allowing for packaging material, before printing. Changing a catalogue product does not immediately update orders already in Starshipit. Use an order imported after saving to verify the setup; reimports follow the integration's normal overwrite behaviour. ## Troubleshooting ### An item still has missing dimensions Check that the imported SKU matches the catalogue product, including the correct variant. Confirm that all three catalogue dimensions are positive and that catalogue population is enabled. If the imported item already has a value, **Only populate missing values** keeps it. Also check whether the integration supplies its own packages or uses a separate import workflow. ### The package looks too small or too large Check the units and the measurements for one item first. Do not multiply the stored item dimensions by the order quantity. A default package can still give an order package dimensions when some item data is missing, so a populated package alone does not prove that every item has valid measurements. ## Related articles - [Set up packages and import weights and dimensions](/articles/206705413-set-up-packages-and-import-weights-and-dimensions) - [Choose how imported item dimensions combine](/articles/1792080615036-choose-how-imported-item-dimensions-combine) - [Configure Product Catalogue settings](/articles/1781620000002-configure-product-catalogue-settings)