---
title: SubscriptionLine - Customer API
description: A line item in a subscription.
api_version: 2025-07
api_name: customer
type: object
api_type: graphql
source_url:
  html: 'https://shopify.dev/docs/api/customer/2025-07/objects/SubscriptionLine'
  md: 'https://shopify.dev/docs/api/customer/2025-07/objects/SubscriptionLine.md'
---

# Subscription​Line

object

A line item in a subscription.

## Fields

* current​Price

  [Money​V2!](https://shopify.dev/docs/api/customer/2025-07/objects/MoneyV2)

  non-null

  The current price per unit for the subscription line in the contract's currency.

* custom​Attributes

  [\[Attribute!\]!](https://shopify.dev/docs/api/customer/2025-07/objects/Attribute)

  non-null

  The custom attributes associated with the line item.

* discount​Allocations

  [\[Subscription​Discount​Allocation!\]!](https://shopify.dev/docs/api/customer/2025-07/objects/SubscriptionDiscountAllocation)

  non-null

  Discount allocations.

* id

  [ID!](https://shopify.dev/docs/api/customer/2025-07/scalars/ID)

  non-null

  The unique ID of the line item.

* image

  [Image](https://shopify.dev/docs/api/customer/2025-07/objects/Image)

  The image associated with the product variant.

* line​Discounted​Price

  [Money​V2!](https://shopify.dev/docs/api/customer/2025-07/objects/MoneyV2)

  non-null

  The total price of the line item after all discounts have been applied.

* name

  [String!](https://shopify.dev/docs/api/customer/2025-07/scalars/String)

  non-null

  The name of the product.

* online​Store​Url

  [URL](https://shopify.dev/docs/api/customer/2025-07/scalars/URL)

  The URL of the product in the online store. A value of `null` indicates that the product isn't published in the Online Store sales channel.

* quantity

  [Int!](https://shopify.dev/docs/api/customer/2025-07/scalars/Int)

  non-null

  The quantity of the unit selected for the subscription line.

* requires​Shipping

  [Boolean!](https://shopify.dev/docs/api/customer/2025-07/scalars/Boolean)

  non-null

  Whether the product variant requires shipping.

* sku

  [String](https://shopify.dev/docs/api/customer/2025-07/scalars/String)

  The SKU of the product variant associated with the subscription line.

* taxable

  [Boolean!](https://shopify.dev/docs/api/customer/2025-07/scalars/Boolean)

  non-null

  Whether the product variant is taxable.

* title

  [String!](https://shopify.dev/docs/api/customer/2025-07/scalars/String)

  non-null

  The title of the product associated with the subscription line.

* variant​Image

  [Image](https://shopify.dev/docs/api/customer/2025-07/objects/Image)

  The image associated with the product variant.

* variant​Title

  [String](https://shopify.dev/docs/api/customer/2025-07/scalars/String)

  The title of the product variant associated with the subscription line.

***

## Map

### Fields and connections with this object

* [SubscriptionContract.lines](https://shopify.dev/docs/api/customer/2025-07/objects/SubscriptionContract#field-SubscriptionContract.fields.lines)
* [SubscriptionContractBase.lines](https://shopify.dev/docs/api/customer/2025-07/interfaces/SubscriptionContractBase#fields-lines)
* [SubscriptionDiscount.lines](https://shopify.dev/docs/api/customer/2025-07/objects/SubscriptionDiscount#field-SubscriptionDiscount.fields.lines)
* [SubscriptionLineConnection.nodes](https://shopify.dev/docs/api/customer/2025-07/connections/SubscriptionLineConnection#returns-nodes)
* [SubscriptionLineEdge.node](https://shopify.dev/docs/api/customer/2025-07/objects/SubscriptionLineEdge#field-SubscriptionLineEdge.fields.node)