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

# Subscription​Line

object

A line item in a subscription.

## Fields

* current​Price

  [Money​V2!](https://shopify.dev/docs/api/customer/latest/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/latest/objects/Attribute)

  non-null

  The custom attributes associated with the line item.

* discount​Allocations

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

  non-null

  Discount allocations.

* id

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

  non-null

  The unique ID of the line item.

* image

  [Image](https://shopify.dev/docs/api/customer/latest/objects/Image)

  The image associated with the product variant.

* line​Discounted​Price

  [Money​V2!](https://shopify.dev/docs/api/customer/latest/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/latest/scalars/String)

  non-null

  The name of the product.

* online​Store​Url

  [URL](https://shopify.dev/docs/api/customer/latest/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/latest/scalars/Int)

  non-null

  The quantity of the unit selected for the subscription line.

* requires​Shipping

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

  non-null

  Whether the product variant requires shipping.

* sku

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

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

* taxable

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

  non-null

  Whether the product variant is taxable.

* title

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

  non-null

  The title of the product associated with the subscription line.

* variant​Image

  [Image](https://shopify.dev/docs/api/customer/latest/objects/Image)

  The image associated with the product variant.

* variant​Title

  [String](https://shopify.dev/docs/api/customer/latest/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/latest/objects/SubscriptionContract#field-lines)
* ||-[SubscriptionContractBase.lines](https://shopify.dev/docs/api/customer/latest/interfaces/SubscriptionContractBase#field-lines)
* {}[SubscriptionDiscount.lines](https://shopify.dev/docs/api/customer/latest/objects/SubscriptionDiscount#field-lines)
* <->[SubscriptionLineConnection.nodes](https://shopify.dev/docs/api/customer/latest/connections/SubscriptionLineConnection#field-nodes)
* {}[SubscriptionLineEdge.node](https://shopify.dev/docs/api/customer/latest/objects/SubscriptionLineEdge#field-node)