# CartLineItem

Describes a cart line item, including product details, pricing, and attributes.

## Type Definition

```graphql
type CartLineItem {
  type: String
  model: String
  image: String
  categoryPath: [String]
  lineDiscount: Float
  price: Float
  linePrice: Float
  netPrice: Float
  tax: Float
  quantity: Int
  title: String
  description: String
  attributesLabel: String
  attributes: [String]
  customizations: [CartLineCustomization]
  gtin: String
  manufacturer: String
  unit: String
  productUrl: String
  bundleItems: [CartLineItem]
  giftCardCode: String
  giftCardValue: Float
  giftCardExpiry: String
  product: Product
  rate: Float
  ratePercentage: Float
  id: Int
  metafields: [Metafield]!
  metafield: Metafield
}
```

## Fields

| Field | Type | Description |
|-------|------|-------------|
| type | String | Returns the type, either product, bundle or gift_card. |
| model | String | Returns the merchant defined model number. |
| image | String | Returns the image. |
| categoryPath | [String] | Returns the category path. |
| lineDiscount | Float | Returns the applied line discount in customer's currency. |
| price | Float | Returns the unit price in customer's currency. |
| linePrice | Float | Returns the line price in customer's currency. |
| netPrice | Float | Returns the net price in customer's currency. |
| tax | Float | Returns the line tax in customer's currency. |
| quantity | Int | Returns the quantity. |
| title | String | Returns the title. |
| description | String | Returns the description. |
| attributesLabel | String | Returns a label for the attributes selected for the product. |
| attributes | [String] | Returns the attributes selected for the product. |
| customizations | [CartLineCustomization] | The customizations applied to this cart line item. For richer data than attributesLabel. |
| gtin | String | Returns a GTIN number for the product. |
| manufacturer | String | Returns the manufacturer. |
| unit | String | Returns a unit for the product. |
| productUrl | String | Returns the product url. |
| bundleItems | [CartLineItem] | Returns the bundle content if the type is bundle. |
| giftCardCode | String | Returns the gift card code if the type is gift_card. |
| giftCardValue | Float | Returns the gift card value in customer's currency if the type is gift_card. |
| giftCardExpiry | String | Returns the gift card expiry date if the type is gift_card. |
| product | Product | Returns the associated product if it's available at the store. |
| rate | Float | Returns the tax rate in decimals. |
| ratePercentage | Float | Returns the tax rate. |
| id | Int | The unique identifier of the cart item. |
| metafields | [Metafield]! | Metafields stored on this resource. |
| metafield | Metafield | A single metafield by namespace and key. |

## Relationships

CartLineItem represents individual items within a shopping cart. It maintains relationships with several key types: it can reference a `Product` object for product-related line items, contains an array of `CartLineCustomization` objects for customization data, may include nested `CartLineItem` objects when the type is bundle, and holds `Metafield` objects for extensible metadata storage. Gift card line items include specific fields for gift card information including code and expiry date.

## Example

```graphql
query {
  cartLineItems {
    id
    type
    title
    quantity
    price
    linePrice
    product {
      id
      title
    }
    customizations {
      label
      value
    }
    metafields {
      namespace
      key
      value
    }
  }
}
```

## Implements

None

## Related Types

- [CartLineCustomization](/reference/storefront/1.3.0/objects/cart-line-customization)
- [CartLineItem](/reference/storefront/1.3.0/objects/cart-line-item)
- [Product](/reference/storefront/1.3.0/objects/product)
- [Metafield](/reference/storefront/1.3.0/objects/metafield)