Line item component information now available for draft orders on the Customer Account API

Shopify's Customer Account API v2026-04 adds a 'components' field to DraftOrderLineItem objects, exposing bundled product sub-components in draft orders. Affects Shopify developers building custom storefronts or order management tools, not Amazon/Walmart/Target sellers.
This is a Shopify developer API change with zero direct impact on marketplace sellers. Only relevant if your agency builds custom Shopify headless commerce or order management integrations using draft orders with bundled products.
Shopify continues incrementally maturing its headless/composable commerce APIs, widening the gap between dev-heavy custom builds and plug-and-play marketplace selling.
If your agency uses Shopify's Customer Account API for draft order automation, audit your lineItems queries before upgrading to v2026-04 -- flattenComponents now defaults to false, which will break flat-list parsing logic.
No action needed for Amazon, Walmart, or Target sellers. File this under Shopify dev maintenance, not marketplace strategy.
Bottom Line
Shopify API update affects dev teams only, not marketplace sellers.
Source Lens
Technical Platform Update
Official but usually technical. Useful only when the change affects merchant-facing operations.
Impact Level
medium
Shopify API update affects dev teams only, not marketplace sellers.
Key Stat / Trigger
No single quantitative trigger surfaced in this report.
Focus on the operational implication, not just the headline.
Full Coverage
Back to Developer changelog April 1, 2026 Tags: Customer Account API 2026-04 Line item component information now available for draft orders on the Customer Account API Ask assistant As of Customer Account API version 2026-04, the Draft Order Line Item object includes a new components field.
This field returns the individual component line items associated with a parent line item. Additionally, a new optional argument, flatten Components, has been introduced to the Draft Order. line Items connection.
For API versions 2026-04 and later, flatten Components defaults to false, meaning only top-level line items are returned as nodes, with their components accessible via the Draft Order Line Item. components field. If set to true, both parent and component line items are returned as top-level nodes, aligning with the behavior of earlier API versions.
For versions prior to 2026-04, flatten Components defaults to true to ensure backward compatibility. Example query {draftOrder(id: "gid://shopify/DraftOrder/1") {lineItems(first: 10) {nodes {name quantity components {name quantity } } } } } Was this section helpful? Yes No
Original Source
This briefing is based on reporting from Shopify Developer Changelog. Use the original post for full primary-source context.
Style
Audience
