---
title: >-
  Manage packed product dimensions with the Admin GraphQL API - Shopify
  developer changelog
description: >-
  Shopify’s developer changelog documents all changes to Shopify’s platform.
  Find the latest news and learn about new platform opportunities.
source_url:
  html: >-
    https://shopify.dev/changelog/posts/manage-packed-product-dimensions-with-the-admin-graphql-api
  md: >-
    https://shopify.dev/changelog/posts/manage-packed-product-dimensions-with-the-admin-graphql-api.md
metadata:
  effectiveApiVersion: 2027-01
  affectedApi:
    - displayName: Admin GraphQL API
      handle: admin-graphql
  primaryTag:
    displayName: API
    handle: api
  secondaryTag:
    displayName: New
    handle: new
  indicatesActionRequired: false
  createdAt: '2026-09-23T10:29:55-04:00'
  postedAt: '2026-09-29T12:00:00-04:00'
  updatedAt: '2026-09-29T10:38:13-04:00'
  effectiveAt: '2026-09-29T12:00:00-04:00'
---

September 29, 2026

# Manage packed product dimensions with the Admin GraphQL API

DateSeptember 29, 2026

Version[2027-01](https://shopify.dev/changelog?api_version=2027-01)

FlagsNew

SurfacesAPI

Affected APIs[Admin GraphQL API](https://shopify.dev/changelog?api_type=admin-graphql)

Starting with the 2027-01 Admin GraphQL API version, apps can read and write packed product dimensions using `InventoryItemMeasurement.packedDimensions` and `InventoryItemMeasurementInput.packedDimensions` in the Admin GraphQL API. Shopify uses these measurements for automatic package selection on eligible multi-item orders.

## What changed

The `packedDimensions` field returns the packed length, width, height, and unit for an inventory item. Mutations that accept `InventoryItemMeasurementInput` can use the same field to save packed dimensions.

When every item in an eligible multi-item order has packed dimensions, Shopify can select the smallest saved package that fits the items. Shopify uses that package to calculate carrier rates at checkout and when the merchant buys a shipping label.

If dimensions are missing or no saved package fits, Shopify keeps the existing package-selection behavior.

## Related docs

* [`InventoryItemMeasurement` reference](https://shopify.dev/docs/api/admin-graphql/2027-01/objects/InventoryItemMeasurement)
* [`InventoryItemMeasurementInput` reference](https://shopify.dev/docs/api/admin-graphql/2027-01/input-objects/InventoryItemMeasurementInput)
* [`ObjectDimensionsInput` reference](https://shopify.dev/docs/api/admin-graphql/2027-01/input-objects/ObjectDimensionsInput)