Add Packed Dimensions, Update Location Inventory Queries

10/10/2026, 12:01:36 AM

Developers should note the new InventoryItemPackedDimensions type that replaces the deprecated BoxDimensions; it uses CENTIMETERS or INCHES and is now returned by InventoryItemMeasurement’s packedDimensions field. The Location object no longer offers inventoryLocationItemQuantities; instead it provides an inventoryLocationItems connection that supports pagination, sorting, filtering (including by SKU), and represents per‑item aggregate quantities. ShippingLabelPurchaseUserErrorCode now includes PICKUP_POINT_NOT_SUPPORTED to signal unsupported pickup points. The Shop type’s allProductCategories and allProductCategoriesList limits have been reduced from 1000 to 500 and the legacy allProductCategories field remains deprecated but usable. New enum values appear in TranslatableResourceType (CHECKOUT_AND_ACCOUNTS_CUSTOM_FIELDS) and TranslationErrorCode (INTERNAL_ERROR), affecting translation resource handling and error reports. These modifications impact inventory queries, error handling, and the dimensions data model for physical products. It is advisable to migrate to the new types and update any custom queries or error checks accordingly.

Type Changes

➕ Added Types (3)

🏗️InventoryItemPackedDimensions➕ AddedOBJECT

The packaged dimensions of an inventory item.

Fields: height, length, unit, width
📥InventoryItemPackedDimensionsInput➕ AddedINPUT_OBJECT

The input fields for the packaged dimensions of an inventory item.

📋InventoryItemPackedDimensionsUnit➕ AddedENUM

The units of measurement supported for the packed dimensions of an inventory item.

Values: CENTIMETERS, INCHES

➖ Removed Types (1)

🏗️BoxDimensions➖ RemovedOBJECT

Represents the dimensions of a three-dimensional box.

Fields: height, length, unit, width

🔄 Modified Types (6)

🏗️InventoryItemMeasurement🔄 Modified
🔄 Field modified: packedDimensions
🏗️Location🔄 Modified
➖ Field removed: inventoryLocationItemQuantities
➕ Field added: inventoryLocationItems

A list of the aggregate inventory quantities, per item, at this location
(summed across the location's bins). Filterable by sku.

Note:
This query is available only in the unstable API version and to development stores
that have enabled the Physical inventory feature preview.

🏗️ShippingLabelPurchaseUserErrorCode🔄 Modified
➕ Enum value added: PICKUP_POINT_NOT_SUPPORTED
🏗️Shop🔄 Modified
🔄 Field modified: allProductCategories
🔄 Field modified: allProductCategoriesList
🏗️TranslatableResourceType🔄 Modified
➕ Enum value added: CHECKOUT_AND_ACCOUNTS_CUSTOM_FIELDS
🏗️TranslationErrorCode🔄 Modified
➕ Enum value added: INTERNAL_ERROR