Shopify’s latest Admin GraphQL API release (2027‑01) gives developers the power to store and retrieve the exact packed dimensions of inventory items. That data isn’t just for reference—it fuels Shopify’s new automatic package selection engine, which chooses the smallest fitting box for eligible multi‑item orders. In this post we’ll break down what changed, who benefits, and exactly how to start using the new fields today.
What Changed: packedDimensions Field and Input
The update introduces two new GraphQL fields:
• InventoryItemMeasurement.packedDimensions – returns length, width, height, and unit for an inventory item.
• InventoryItemMeasurementInput.packedDimensions – accepts the same structure in mutations, allowing apps to save those measurements.
When every line item in an eligible order has packed dimensions, Shopify can automatically match the order to the smallest saved package that fits, improving carrier‑rate accuracy and reducing shipping costs.
Why It Matters for Merchants
Merchants selling multiple SKUs often rely on manual packaging rules or guesswork, which can lead to oversized boxes, higher rates, and wasted packing material. With packed dimensions stored at the inventory‑item level, Shopify’s fulfillment logic now selects the optimal box without any extra configuration. The result is:
• Lower shipping fees on average, because carriers see the true package size. • Faster checkout experiences – rates are calculated on‑the‑fly with the correct dimensions. • Reduced environmental impact from over‑packaging.
How Developers Can Implement the Change
The new fields live in the Admin GraphQL schema, so any custom app, private integration, or Shopify‑Plus script that already talks to the Admin API can start using them immediately. The key steps are:
1️⃣ Add the packedDimensions sub‑field to your inventory‑item queries. 2️⃣ When creating or updating an inventory item, include an InventoryItemMeasurementInput with the packedDimensions object. 3️⃣ Test both read and write paths in a development store before rolling out to production.
Sample Query: Reading Packed Dimensions
graphql
query GetPackedDimensions($inventoryItemId: ID!) {
inventoryItem(id: $inventoryItemId) {
id
measurement {
packedDimensions {
length
width
height
unit
}
}
}
}
Sample Mutation: Writing Packed Dimensions
graphql
mutation UpdatePackedDimensions($inventoryItemId: ID!, $input: InventoryItemMeasurementInput!) {
inventoryItemUpdate(id: $inventoryItemId, measurement: $input) {
inventoryItem {
id
measurement {
packedDimensions {
length
width
height
unit
}
}
}
userErrors { field message }
}
}
# Variables example
{
"inventoryItemId": "gid://shopify/InventoryItem/123456789",
"input": {
"packedDimensions": {
"length": 12.0,
"width": 8.5,
"height": 4.0,
"unit": "IN"
}
}
}
Impact on Automatic Package Selection
Shopify’s fulfillment engine now runs a simple fit‑algorithm whenever an order contains multiple items that each have packed dimensions recorded. If a saved package (defined in Shipping > Packages) can contain the combined volume, that package is chosen and its dimensions are sent to the carrier’s rate calculator. If any item is missing packed data, or no saved box fits, Shopify falls back to the previous “first‑fit” logic, which may result in larger or less accurate rates.
Migration Checklist for Merchants & Developers
✅ Audit existing inventory items – identify SKUs without packed dimensions.
✅ Update your product import pipelines (CSV, API, or apps) to include length, width, height, and unit in the measurement input.
✅ Verify that your saved package list includes boxes that can accommodate the new dimensions.
✅ Run end‑to‑end tests on a sandbox store: place a multi‑item order, proceed to checkout, and confirm the carrier rate reflects the smaller package.
✅ Monitor the “Shipping” analytics dashboard for any sudden spikes in rate calculations after launch – this helps catch items that were missed during the data back‑fill.
Conclusion & Next Steps
The 2027‑01 Admin GraphQL update removes a long‑standing blind spot in Shopify’s fulfillment workflow. By exposing packed dimensions at the inventory‑item level, developers can build richer tooling, and merchants can enjoy leaner packaging and lower shipping costs automatically. If you haven’t yet added packed dimensions to your catalog, now is the perfect time – start with a small batch, verify the automatic box selection, then scale across your entire inventory. Need help updating your integration or configuring packages? Reach out to a Shopify Plus Partner or drop a comment below – we’re happy to guide you through the transition.
