# line_item
## Overview
A line_item represents a product variant within a cart, checkout, or order. Each line contains pricing, quantity, and product variant details.
## Properties
| Property | Type | Description |
|----------|------|-------------|
| `discount_allocations` | array of discount_allocation | "The discount allocations that apply to the line item" |
| `error_message` | string | Status message about the line item (cart only, Checkout Extensibility) |
| `final_line_price` | number | Combined price of all items including discounts, in currency subunits |
| `final_price` | number | Individual line item price including discounts, in currency subunits |
| `fulfillment` | fulfillment | The fulfillment details for the line item |
| `fulfillment_service` | string | Service handling fulfillment; defaults to 'manual' if none exists |
| `gift_card` | boolean | Whether the product is a gift card |
| `grams` | number | Weight in store's default unit |
| `id` | number | Line item identifier (context-dependent; varies by cart/checkout/order) |
| `image` | image | Variant or product featured image |
| `instructions` | instructions | "Instructions define behaviours and operations that can be performed on the nested cart line" (cart only) |
| `item_components` | array of line_item | Components of the line item (cart only) |
| `key` | string | Unique identifier from variant ID and characteristic hash |
| `line_level_discount_allocations` | array of discount_allocation | Direct discounts on the line item |
| `line_level_total_discount` | number | Total discount amount in currency subunits |
| `message` | string | Information about discounts affecting the line |
| `options_with_values` | array | "The name and value pairs for each option of the variant" |
| `original_line_price` | number | Combined pre-discount price |
| `original_price` | number | Individual pre-discount price |
| `parent_relationship` | parent_relationship | Parent relationship for nested items (cart only) |
| `product` | product | Associated product object |
| `product_id` | number | Product identifier |
| `properties` | object | Custom line item information (name/value pairs) |
| `quantity` | number | Item quantity |
| `requires_shipping` | boolean | Whether shipping is required |
| `selling_plan_allocation` | selling_plan_allocation | Subscription or plan details if applicable |
| `sku` | string | Variant stock keeping unit |
| `successfully_fulfilled_quantity` | number | Items successfully fulfilled |
| `tax_lines` | array of tax_line | Tax details for the line |
| `taxable` | boolean | Whether taxes apply |
| `title` | string | "A combination of product.title and variant.title, separated by a hyphen" |
| `unit_price` | number | Price per measurement unit in currency subunits |
| `unit_price_measurement` | unit_price_measurement | Measurement details for unit pricing |
| `url` | string | Relative variant URL |
| `url_to_remove` | string | URL to remove item from cart |
| `variant` | variant | Associated variant object |
| `variant_id` | number | Variant identifier |
| `vendor` | string | Variant vendor |
## Deprecated Properties
- `discounts` → Use `discount_allocations`
- `line_price` → Use `final_line_price`
- `price` → Use `final_price`
- `total_discount` → Use `line_level_total_discount`