--- title: LineItem - Customer API description: A single line item in an order. api_version: 2026-07 source_url: html: 'https://shopify.dev/docs/api/customer/latest/objects/LineItem' md: 'https://shopify.dev/docs/api/customer/latest/objects/LineItem.md' api_name: customer api_type: graphql type: object --- # Line​Item object Requires `customer_read_orders` access scope. A single line item in an order. ## Fields * current​Total​Price [Money​V2](https://shopify.dev/docs/api/customer/latest/objects/MoneyV2) The total price of the line item, calculated by multiplying the current unit price of the variant by the quantity, expressed in presentment currencies. * custom​Attributes [\[Attribute!\]!](https://shopify.dev/docs/api/customer/latest/objects/Attribute) non-null The list of custom attributes associated with the line item. * discount​Allocations [\[Discount​Allocation!\]!](https://shopify.dev/docs/api/customer/latest/objects/DiscountAllocation) non-null The discounts that have been allocated onto the line item by discount applications. * gift​Card [Boolean!](https://shopify.dev/docs/api/customer/latest/scalars/Boolean) non-null Whether the line item represents the purchase of a gift card. * group [Line​Item​Group](https://shopify.dev/docs/api/customer/latest/objects/LineItemGroup) The line item group associated to the line item. * id [ID!](https://shopify.dev/docs/api/customer/latest/scalars/ID) non-null A globally-unique ID. * image [Image](https://shopify.dev/docs/api/customer/latest/objects/Image) The image object associated with the line item. * name [String!](https://shopify.dev/docs/api/customer/latest/scalars/String) non-null The name of the product. * presentment​Title [String](https://shopify.dev/docs/api/customer/latest/scalars/String) The title of the line item variant. * price [Money​V2](https://shopify.dev/docs/api/customer/latest/objects/MoneyV2) The product variant price without any discounts applied, in presentment currencies. * product​Id [ID](https://shopify.dev/docs/api/customer/latest/scalars/ID) The product's ID. * product​Type [String](https://shopify.dev/docs/api/customer/latest/scalars/String) The product's type. * quantity [Int!](https://shopify.dev/docs/api/customer/latest/scalars/Int) non-null The number of variant items ordered. * refundable​Quantity [Int!](https://shopify.dev/docs/api/customer/latest/scalars/Int) non-null The quantity of the line item, minus the refunded quantity. * requires​Shipping [Boolean!](https://shopify.dev/docs/api/customer/latest/scalars/Boolean) non-null Whether physical shipping is required for the variant. * sku [String](https://shopify.dev/docs/api/customer/latest/scalars/String) The SKU number of the variant. * suggested​Return​Reason​Definitions [Return​Reason​Definition​Connection](https://shopify.dev/docs/api/customer/latest/connections/ReturnReasonDefinitionConnection) Return reasons suggested based on the line item's product category in Shopify's product taxonomy. These are a curated subset of the full library of available reasons via the [`returnReasonDefinitions`](https://shopify.dev/docs/api/admin-graphql/latest/queries/returnReasonDefinitions) query. * after [String](https://shopify.dev/docs/api/customer/latest/scalars/String) ### Arguments The elements that come after the specified [cursor](https://shopify.dev/api/usage/pagination-graphql). * before [String](https://shopify.dev/docs/api/customer/latest/scalars/String) The elements that come before the specified [cursor](https://shopify.dev/api/usage/pagination-graphql). * first [Int](https://shopify.dev/docs/api/customer/latest/scalars/Int) The first `n` elements from the [paginated list](https://shopify.dev/api/usage/pagination-graphql). * last [Int](https://shopify.dev/docs/api/customer/latest/scalars/Int) The last `n` elements from the [paginated list](https://shopify.dev/api/usage/pagination-graphql). * reverse [Boolean](https://shopify.dev/docs/api/customer/latest/scalars/Boolean) Default:false Reverse the order of the underlying list. *** * title [String!](https://shopify.dev/docs/api/customer/latest/scalars/String) non-null The title of the product or variant. This field only applies to custom line items. * total​Discount [Money​V2!](https://shopify.dev/docs/api/customer/latest/objects/MoneyV2) non-null The total of the discount allocations on this line item, resulting from discounts applied specifically to this line item. * total​Price [Money​V2](https://shopify.dev/docs/api/customer/latest/objects/MoneyV2) The total price of the line item, calculated by multiplying the current unit price of the variant by the quantity, expressed in presentment currencies. * unit​Price [Unit​Price](https://shopify.dev/docs/api/customer/latest/objects/UnitPrice) The unit price of the line item in presentment currencies. * variant​Id [ID](https://shopify.dev/docs/api/customer/latest/scalars/ID) The ID of the variant. * variant​Options [\[Line​Item​Variant​Option!\]](https://shopify.dev/docs/api/customer/latest/objects/LineItemVariantOption) The options of the product variant. * variant​Title [String](https://shopify.dev/docs/api/customer/latest/scalars/String) The name of the variant. * vendor [String](https://shopify.dev/docs/api/customer/latest/scalars/String) The product's vendor. *** ## Map ### Fields and connections with this object * [CalculatedReturnLineItem.lineItem](https://shopify.dev/docs/api/customer/latest/objects/CalculatedReturnLineItem#field-CalculatedReturnLineItem.fields.lineItem) * [FulfillmentLineItem.lineItem](https://shopify.dev/docs/api/customer/latest/objects/FulfillmentLineItem#field-FulfillmentLineItem.fields.lineItem) * [GiftCardSale.lineItem](https://shopify.dev/docs/api/customer/latest/objects/GiftCardSale#field-GiftCardSale.fields.lineItem) * [LineItemConnection.nodes](https://shopify.dev/docs/api/customer/latest/connections/LineItemConnection#returns-nodes) * [LineItemEdge.node](https://shopify.dev/docs/api/customer/latest/objects/LineItemEdge#field-LineItemEdge.fields.node) * [NonReturnableLineItem.lineItem](https://shopify.dev/docs/api/customer/latest/objects/NonReturnableLineItem#field-NonReturnableLineItem.fields.lineItem) * [Order.lineItems](https://shopify.dev/docs/api/customer/latest/objects/Order#field-Order.fields.lineItems) * [ProductSale.lineItem](https://shopify.dev/docs/api/customer/latest/objects/ProductSale#field-ProductSale.fields.lineItem) * [ReturnLineItem.lineItem](https://shopify.dev/docs/api/customer/latest/objects/ReturnLineItem#field-ReturnLineItem.fields.lineItem) * [ReturnLineItemType.lineItem](https://shopify.dev/docs/api/customer/latest/interfaces/ReturnLineItemType#fields-lineItem) * [ReturnableLineItem.lineItem](https://shopify.dev/docs/api/customer/latest/objects/ReturnableLineItem#field-ReturnableLineItem.fields.lineItem) * [TipSale.lineItem](https://shopify.dev/docs/api/customer/latest/objects/TipSale#field-TipSale.fields.lineItem) * [UnverifiedReturnLineItem.lineItem](https://shopify.dev/docs/api/customer/latest/objects/UnverifiedReturnLineItem#field-UnverifiedReturnLineItem.fields.lineItem) *** ## Interfaces * [Node](https://shopify.dev/docs/api/customer/latest/interfaces/Node) interface *** ## LineItem Implements ### Implements * [Node](https://shopify.dev/docs/api/customer/latest/interfaces/Node)