OrderLineItem

A single line on a customer Order. May reference a product, a custom item, or a promotion — see type to disambiguate.

type OrderLineItem implements Node {
  id: ID!
  description: String
  identifier: String!
  label: String!
  orderId: ID!
  productId: ID
  quantity: Int!
  shippedQuantity: Int
  shopifyId: String
  totalPrice: Float
  type: String
  unitPrice: Float
  children(
    first: Int = 10
    after: String
    filter: OrderLineItemFilterInput
  ): OrderLineItemConnection
  order: Order
  parent: OrderLineItem
  product: Product
}

Fields

OrderLineItem.id ● ID! non-null scalar

Global identifier for this entity.

OrderLineItem.description ● String scalar

Optional secondary description rendered below the label.

OrderLineItem.identifier ● String! non-null scalar

Stable identifier carried over from the cart line. Matches payload.identifier for promotion lines.

OrderLineItem.label ● String! non-null scalar

Display label as shown to the customer at checkout. Frozen at order placement; subsequent product renames do not propagate.

OrderLineItem.orderId ● ID! non-null scalar

ID of the parent order.

OrderLineItem.productId ● ID scalar

ID of the referenced product when type = "product".

OrderLineItem.quantity ● Int! non-null scalar

Ordered quantity. Always positive.

OrderLineItem.shippedQuantity ● Int scalar

Number of units already shipped against this line. Equals quantity once the line is fully shipped.

OrderLineItem.shopifyId ● String scalar

Shopify GID of the order line item, e.g. gid://shopify/LineItem/7123. Null for a line item Shopify has no line item for, e.g. a discount, and for an order that was not imported from Shopify.

OrderLineItem.totalPrice ● Float scalar

Gross line total in the order's currency (unitPrice * quantity, minus per-line discounts).

OrderLineItem.type ● String scalar

Line item type discriminator (product, custom, promotion, credit, …). Determines which other fields and references are meaningful.

OrderLineItem.unitPrice ● Float scalar

Gross unit price in the order's currency.

OrderLineItem.children ● OrderLineItemConnection object

OrderLineItem.children.first ● Int scalar

OrderLineItem.children.after ● String scalar

OrderLineItem.children.filter ● OrderLineItemFilterInput input

OrderLineItem.order ● Order object

OrderLineItem.parent ● OrderLineItem object

OrderLineItem.product ● Product object

Interfaces

Node interface

Any entity that can be loaded by its global id through the node(id: ID!) query.

Returned By

orderLineItem query

Member Of

FulfillmentOrderLineItem object ● OrderLineItem object ● OrderLineItemEdge object