---
title: SubscriptionGroupedLine - GraphQL Admin
description: >-
  A subscription contract line grouped by bundle parent: either a standalone
  line or a bundle parent line and its components.
api_version: 2026-10
source_url:
  html: >-
    https://shopify.dev/docs/api/admin-graphql/latest/unions/SubscriptionGroupedLine
  md: >-
    https://shopify.dev/docs/api/admin-graphql/latest/unions/SubscriptionGroupedLine.md
api_name: admin
api_type: graphql
type: union
---

# Subscription​Grouped​Line

union

Requires the `read_own_subscription_contracts` or `write_own_subscription_contracts` scope.

A subscription contract line grouped by bundle parent: either a standalone line or a bundle parent line and its components.

## Fields with this union

* [Subscription​Billing​Cycle​Edited​Contract.groupedLines](https://shopify.dev/docs/api/admin-graphql/latest/objects/SubscriptionBillingCycleEditedContract#field-SubscriptionBillingCycleEditedContract.fields.groupedLines)

  OBJECT

  Represents a subscription contract with billing cycles.

* [Subscription​Calculated​Contract.groupedLines](https://shopify.dev/docs/api/admin-graphql/latest/objects/SubscriptionCalculatedContract#field-SubscriptionCalculatedContract.fields.groupedLines)

  OBJECT

  A calculated subscription contract that can be previewed before committing.

* [Subscription​Contract.groupedLines](https://shopify.dev/docs/api/admin-graphql/latest/objects/SubscriptionContract#field-SubscriptionContract.fields.groupedLines)

  OBJECT

  A subscription contract that defines recurring purchases for a customer. Each contract specifies what products to deliver, when to bill and ship them, and at what price.

  The contract includes [`SubscriptionBillingPolicy`](https://shopify.dev/docs/api/admin-graphql/latest/objects/SubscriptionBillingPolicy) and [`SubscriptionDeliveryPolicy`](https://shopify.dev/docs/api/admin-graphql/latest/objects/SubscriptionDeliveryPolicy) that control the frequency of charges and fulfillments. [`SubscriptionLine`](https://shopify.dev/docs/api/admin-graphql/latest/objects/SubscriptionLine) items define the products, quantities, and pricing for each recurring [`Order`](https://shopify.dev/docs/api/admin-graphql/latest/objects/Order). The contract tracks [`SubscriptionBillingAttempt`](https://shopify.dev/docs/api/admin-graphql/latest/objects/SubscriptionBillingAttempt) records, payment status, and generated orders throughout its lifecycle. [`App`](https://shopify.dev/docs/api/admin-graphql/latest/objects/App) instances manage contracts through various status transitions including active, paused, failed, cancelled, or expired states.

  Learn more about [building subscription contracts](https://shopify.dev/docs/apps/build/purchase-options/subscriptions/contracts/build-a-subscription-contract) and [updating subscription contracts](https://shopify.dev/docs/apps/build/purchase-options/subscriptions/contracts/update-a-subscription-contract).

* [Subscription​Contract​Base.groupedLines](https://shopify.dev/docs/api/admin-graphql/latest/interfaces/SubscriptionContractBase#fields-groupedLines)

  INTERFACE

  Represents subscription contract common fields.

* [Subscription​Grouped​Line​Connection.nodes](https://shopify.dev/docs/api/admin-graphql/latest/connections/SubscriptionGroupedLineConnection#returns-nodes)

  CONNECTION

  An auto-generated type for paginating through multiple SubscriptionGroupedLines.

* [Subscription​Grouped​Line​Edge.node](https://shopify.dev/docs/api/admin-graphql/latest/objects/SubscriptionGroupedLineEdge#field-SubscriptionGroupedLineEdge.fields.node)

  OBJECT

  An auto-generated type which holds one SubscriptionGroupedLine and a cursor during pagination.

***

```graphql
union SubscriptionGroupedLine = SubscriptionLine | SubscriptionParentLine
```