← Latest Shopify changes
Action / breaking change

DraftOrderLineItem.grams field removed in 2026-07

Action RequiredAPIBreaking API Change2026-07

Shopify developer change

MerchantDiff detected this entry in Shopify's official developer changelog on April 13, 2026.

This Shopify update is categorized as Action Required, API, Breaking API Change, 2026-07.

What changed

We are removing the grams field from the DraftOrderLineItem object in the Admin GraphQL API, starting with version 2026-07. This field was deprecated over 8 years ago. After the 2026-04 API version becomes unsupported, any queries referencing DraftOrderLineItem.grams will return an error.

Who is affected

Apps using the affected Shopify GraphQL API surface should review this change.

What action may be needed

Replace any usage of grams with the weight field on DraftOrderLineItem. The weight field returns both a value and a unit, giving you more flexibility than the old grams integer.

Referenced API version: 2026-07

Use the official Shopify entry below as the source of truth for technical implementation details, affected APIs, migration instructions and deadlines.

Want the actionable version?

MerchantDiff monitors Shopify API changes, deprecations, deadlines and ecosystem updates, then turns them into developer-focused release intelligence: what changed, who is affected and what action may be needed.

Get MerchantDiff →