---
title: LineItem - GraphQL Admin
description: >-
  The `LineItem` object represents a single product or service that a customer
  purchased in an

  [order](https://shopify.dev/docs/api/admin-graphql/latest/objects/Order).

  Each line item is associated with a

  [product
  variant](https://shopify.dev/docs/api/admin-graphql/latest/objects/ProductVariant)

  and can have multiple [discount
  allocations](https://shopify.dev/docs/api/admin-graphql/latest/objects/DiscountAllocation).

  Line items contain details about what was purchased, including the product
  variant, quantity, pricing,

  and fulfillment status.


  Use the `LineItem` object to manage the following processes:


  - [Track the quantity of
  items](https://shopify.dev/docs/apps/build/orders-fulfillment/order-management-apps/build-fulfillment-solutions)
  ordered, fulfilled, and unfulfilled.

  - [Calculate
  prices](https://shopify.dev/docs/apps/build/orders-fulfillment/order-management-apps/edit-orders),
  including discounts and taxes.

  - Manage fulfillment through [fulfillment
  services](https://shopify.dev/docs/apps/build/orders-fulfillment/fulfillment-service-apps).

  - Manage
  [returns](https://shopify.dev/docs/apps/build/orders-fulfillment/returns-apps/build-return-management)
  and
  [exchanges](https://shopify.dev/docs/apps/build/orders-fulfillment/returns-apps/manage-exchanges).

  - Handle
  [subscriptions](https://shopify.dev/docs/apps/build/purchase-options/subscriptions)
  and recurring orders.


  Line items can also include custom attributes and properties, allowing
  merchants to add specific details

  about each item in an order. Learn more about

  [managing orders and
  fulfillment](https://shopify.dev/docs/apps/build/orders-fulfillment).
api_version: 2026-01
api_name: admin
type: object
api_type: graphql
source_url:
  html: 'https://shopify.dev/docs/api/admin-graphql/latest/objects/LineItem'
  md: 'https://shopify.dev/docs/api/admin-graphql/latest/objects/LineItem.md'
---

# Line​Item

object

Requires `read_orders` access scope or `read_marketplace_orders` access scope.

The `LineItem` object represents a single product or service that a customer purchased in an [order](https://shopify.dev/docs/api/admin-graphql/latest/objects/Order). Each line item is associated with a [product variant](https://shopify.dev/docs/api/admin-graphql/latest/objects/ProductVariant) and can have multiple [discount allocations](https://shopify.dev/docs/api/admin-graphql/latest/objects/DiscountAllocation). Line items contain details about what was purchased, including the product variant, quantity, pricing, and fulfillment status.

Use the `LineItem` object to manage the following processes:

* [Track the quantity of items](https://shopify.dev/docs/apps/build/orders-fulfillment/order-management-apps/build-fulfillment-solutions) ordered, fulfilled, and unfulfilled.
* [Calculate prices](https://shopify.dev/docs/apps/build/orders-fulfillment/order-management-apps/edit-orders), including discounts and taxes.
* Manage fulfillment through [fulfillment services](https://shopify.dev/docs/apps/build/orders-fulfillment/fulfillment-service-apps).
* Manage [returns](https://shopify.dev/docs/apps/build/orders-fulfillment/returns-apps/build-return-management) and [exchanges](https://shopify.dev/docs/apps/build/orders-fulfillment/returns-apps/manage-exchanges).
* Handle [subscriptions](https://shopify.dev/docs/apps/build/purchase-options/subscriptions) and recurring orders.

Line items can also include custom attributes and properties, allowing merchants to add specific details about each item in an order. Learn more about [managing orders and fulfillment](https://shopify.dev/docs/apps/build/orders-fulfillment).

## Fields

* contract
* currentQuantity
* customAttributes
* discountAllocations
* discountedTotalSet
* discountedUnitPriceAfterAllDiscountsSet
* discountedUnitPriceSet
* duties
* id
* image
* isGiftCard
* lineItemGroup
* merchantEditable
* name
* nonFulfillableQuantity
* originalTotalSet
* originalUnitPriceSet
* product
* quantity
* refundableQuantity
* requiresShipping
* restockable
* sellingPlan
* sku
* staffMember
* suggestedReturnReasonDefinitions
* taxable
* taxLines
* title
* totalDiscountSet
* unfulfilledDiscountedTotalSet
* unfulfilledOriginalTotalSet
* unfulfilledQuantity
* variant
* variantTitle
* vendor

### Deprecated fields

* canRestock: deprecated
* discountedTotal: deprecated
* discountedUnitPrice: deprecated
* fulfillableQuantity: deprecated
* fulfillmentService: deprecated
* fulfillmentStatus: deprecated
* originalTotal: deprecated
* originalUnitPrice: deprecated
* totalDiscount: deprecated
* unfulfilledDiscountedTotal: deprecated
* unfulfilledOriginalTotal: deprecated

***

## Map

### Fields and connections with this object

* [ExchangeLineItem.lineItems](https://shopify.dev/docs/api/admin-graphql/latest/objects/ExchangeLineItem#field-ExchangeLineItem.fields.lineItems)
* [FulfillmentLineItem.lineItem](https://shopify.dev/docs/api/admin-graphql/latest/objects/FulfillmentLineItem#field-FulfillmentLineItem.fields.lineItem)
* [FulfillmentOrderLineItem.lineItem](https://shopify.dev/docs/api/admin-graphql/latest/objects/FulfillmentOrderLineItem#field-FulfillmentOrderLineItem.fields.lineItem)
* [GiftCardSale.lineItem](https://shopify.dev/docs/api/admin-graphql/latest/objects/GiftCardSale#field-GiftCardSale.fields.lineItem)
* [LineItemConnection.nodes](https://shopify.dev/docs/api/admin-graphql/latest/connections/LineItemConnection#returns-nodes)
* [LineItemEdge.node](https://shopify.dev/docs/api/admin-graphql/latest/objects/LineItemEdge#field-LineItemEdge.fields.node)
* [Order.lineItems](https://shopify.dev/docs/api/admin-graphql/latest/objects/Order#field-Order.fields.lineItems)
* [Order.nonFulfillableLineItems](https://shopify.dev/docs/api/admin-graphql/latest/objects/Order#field-Order.fields.nonFulfillableLineItems)
* [OrderStagedChangeDecrementItem.lineItem](https://shopify.dev/docs/api/admin-graphql/latest/objects/OrderStagedChangeDecrementItem#field-OrderStagedChangeDecrementItem.fields.lineItem)
* [OrderStagedChangeIncrementItem.lineItem](https://shopify.dev/docs/api/admin-graphql/latest/objects/OrderStagedChangeIncrementItem#field-OrderStagedChangeIncrementItem.fields.lineItem)
* [ProductSale.lineItem](https://shopify.dev/docs/api/admin-graphql/latest/objects/ProductSale#field-ProductSale.fields.lineItem)
* [RefundLineItem.lineItem](https://shopify.dev/docs/api/admin-graphql/latest/objects/RefundLineItem#field-RefundLineItem.fields.lineItem)
* [TipSale.lineItem](https://shopify.dev/docs/api/admin-graphql/latest/objects/TipSale#field-TipSale.fields.lineItem)

***

## Interfaces

* Node

***

## LineItem Implements

### Implements

* [Node](https://shopify.dev/docs/api/admin-graphql/latest/interfaces/Node)