---
title: CartDeliveryGroup - Storefront API
description: >
  Groups cart line items that share the same delivery destination. Each group
  provides the available
  [`CartDeliveryOption`](/docs/api/storefront/2026-04/objects/CartDeliveryOption)
  choices for that address, along with the customer's selected option.


  Access through the [`Cart`](/docs/api/storefront/2026-04/objects/Cart)
  object's `deliveryGroups` field. Items are grouped by merchandise type
  (one-time purchase vs subscription), allowing different delivery methods for
  each.
api_version: 2026-04
api_name: storefront
type: object
api_type: graphql
source_url:
  html: 'https://shopify.dev/docs/api/storefront/latest/objects/CartDeliveryGroup'
  md: 'https://shopify.dev/docs/api/storefront/latest/objects/CartDeliveryGroup.md'
---

# Cart​Delivery​Group

object

Groups cart line items that share the same delivery destination. Each group provides the available [`CartDeliveryOption`](https://shopify.dev/docs/api/storefront/2026-04/objects/CartDeliveryOption) choices for that address, along with the customer's selected option.

Access through the [`Cart`](https://shopify.dev/docs/api/storefront/2026-04/objects/Cart) object's `deliveryGroups` field. Items are grouped by merchandise type (one-time purchase vs subscription), allowing different delivery methods for each.

## Fields

* cart​Lines

  [Base​Cart​Line​Connection!](https://shopify.dev/docs/api/storefront/latest/connections/BaseCartLineConnection)

  non-null

  A list of cart lines for the delivery group.

  * first

    [Int](https://shopify.dev/docs/api/storefront/latest/scalars/Int)

    ### Arguments

    Returns up to the first `n` elements from the list.

  * after

    [String](https://shopify.dev/docs/api/storefront/latest/scalars/String)

    Returns the elements that come after the specified cursor.

  * last

    [Int](https://shopify.dev/docs/api/storefront/latest/scalars/Int)

    Returns up to the last `n` elements from the list.

  * before

    [String](https://shopify.dev/docs/api/storefront/latest/scalars/String)

    Returns the elements that come before the specified cursor.

  * reverse

    [Boolean](https://shopify.dev/docs/api/storefront/latest/scalars/Boolean)

    Default:false

    Reverse the order of the underlying list.

  ***

* delivery​Address

  [Mailing​Address!](https://shopify.dev/docs/api/storefront/latest/objects/MailingAddress)

  non-null

  The destination address for the delivery group.

* delivery​Options

  [\[Cart​Delivery​Option!\]!](https://shopify.dev/docs/api/storefront/latest/objects/CartDeliveryOption)

  non-null

  The delivery options available for the delivery group.

* group​Type

  [Cart​Delivery​Group​Type!](https://shopify.dev/docs/api/storefront/latest/enums/CartDeliveryGroupType)

  non-null

  The type of merchandise in the delivery group.

* id

  [ID!](https://shopify.dev/docs/api/storefront/latest/scalars/ID)

  non-null

  The ID for the delivery group.

* selected​Delivery​Option

  [Cart​Delivery​Option](https://shopify.dev/docs/api/storefront/latest/objects/CartDeliveryOption)

  The selected delivery option for the delivery group.

***

## Map

### Fields and connections with this object

* [Cart.deliveryGroups](https://shopify.dev/docs/api/storefront/latest/objects/Cart#field-Cart.fields.deliveryGroups)
* [CartDeliveryGroupConnection.nodes](https://shopify.dev/docs/api/storefront/latest/connections/CartDeliveryGroupConnection#returns-nodes)
* [CartDeliveryGroupEdge.node](https://shopify.dev/docs/api/storefront/latest/objects/CartDeliveryGroupEdge#field-CartDeliveryGroupEdge.fields.node)