Fine-Tuning Item Packing Limits with Compatible Packages

Overview

UltraCart does not provide a direct setting to limit the quantity of a single item that can fit in one package. Instead, the system relies on dimensional weight and physical compatibility calculations to determine how items pack into configured packages for each shipping method.

The Compatible Packages tool (available in the Item Editor) lets you preview exactly how an item fits into available packages. By reviewing the Fill Capacity percentage and Packed Weight, you can fine-tune the item’s dimensions, weight, or the package configurations to achieve a precise quantity cutoff per package.

This tutorial walks you through using the tool to simulate and adjust packing behavior. Merchants often slightly adjust (“fudge”) dimensions or weights to enforce a clean cutoff (e.g., exactly 2 units per box) while keeping shipping rates accurate.

What You’ll Need

• Administrator access to your UltraCart account

• An item already created and saved in the Item Editor

• At least one shipping method configured (e.g., FedEx Ground)

• One or more packages defined under Configuration → Checkout → Shipping → Packages

• The physical dimensions and weight of the item (or your desired cutoff logic)

Steps

1. Open the Item Editor Go to Items → Item Editor and search for or select the item you want to configure (example: AnkleHighBoots-02).

2. Navigate to the Shipping tab Click the Shipping tab in the item editor.

3. Locate the method-specific options Scroll to the shipping method you want to control (e.g., FedEx: Ground). In the method-specific options sub-tab, you will see a button labeled Compatible Packages.

   Open

   

    

    

4. Run the Compatible Packages calculation Click Compatible Packages. UltraCart will display a table showing every package configured for that shipping method, with columns for:

   • Status (OK [BEST], Item too large, etc.)

   • Fill Capacity (percentage of the package used by one unit of the item)

   • External / Internal Dimensions

   • Packed Weight

   • Exceptions

   Example output when a package fits well:

   PackageStatusFill CapacityExternal DimensionsPacked Weight16"x14"x8" boxOK [BEST]39.70%16 IN x 14 IN x 8 IN3 LB

   Tip: A Fill Capacity under ~50% usually means at least two units of the item will fit. Use this number to calculate your desired cutoff (e.g., 39% × 3 = 117% → max 2 units).

5. Analyze the current cutoff

   • If the best-fit package shows a low Fill Capacity, multiple units will pack together.

   • If you see Item too large or NO COMPATIBLE PACKAGES FOUND, the item will not ship with that method until you adjust dimensions.

   • Note the Packed Weight—this also factors into shipping method restrictions.

6. Adjust item dimensions or weight (primary method) Return to the main Item tab (or the Shipping tab’s general fields) and edit:

   • Length, Width, Height (in inches)

   • Weight (in pounds/ounces)

   Common adjustments:

   • Increase one dimension slightly to reduce how many units fit.

   • Add a small “fudge factor” (e.g., +0.1–0.5 inches) to force a clean cutoff.

7. (Optional) Adjust package dimensions Go to Configuration → Checkout → Shipping → Packages. Edit the relevant package’s external/internal dimensions or maximum weight. Return to the item and re-run step 4 to verify the change.

8. Re-test with Compatible Packages Click the button again after every change. Repeat steps 6–7 until the Fill Capacity produces the exact quantity cutoff you want.

9. Save the item Click Save Item at the bottom of the editor.

10. Verify in a test order (recommended) Add the desired quantity to a test cart using the shipping method and confirm only the intended number of units packs into each package.

Expected Outcome

After fine-tuning, the Compatible Packages report will clearly show:

• One or more packages marked OK [BEST] with a Fill Capacity that mathematically limits the item to your target quantity (e.g., 60% fill = maximum of 1 unit).

• No unexpected “Item too large” errors for the intended quantity.

• Accurate shipping rates based on the adjusted packed weight.

Your packing logic now behaves as if you had a native “max units per package” setting.

Examples

Example: ‘No Compatible Packages, Item too large’

Open

Example:: ‘No Compatible Packages found (no packages have been assigned)’

Open

Example: ‘Multiple Compatible Packages Comparison’

Open

Troubleshooting

Note: Dimensional packing is the only native mechanism UltraCart uses to control quantities per package. The “fudge factor” technique is a common and fully supported merchant practice to achieve business-specific rules without custom development.

Next Steps

• Review your other high-volume items using the same process.

• Document your fudge-factor adjustments in an internal note on the item for future reference.

• Test shipping rates and label generation with the new configuration before going live.

• For advanced scenarios (e.g., conditional rules by order value), combine this with Shipping Method Restrictions.