Skip to main content

New: Support for nested cart lines

New fields have been introduced to enable parent-child (nested) relationships between cart lines, supporting use cases such as warranties, engravings, and gift-wrapping.

  • Nested cart lines are now supported in the Cart AJAX API, and as of version 2025-10, in Storefront API and Checkout UI Extensions.

  • Nested (child) lines reference their parent using a dedicated parent field: Use parentId or parent_line_key (Cart AJAX API), parentID (Checkout UI Extensions), parent.lineId or parent.merchandiseId (Storefront API).

To learn more about the impacted APIs and fields, click here.

Was this section helpful?