# CartItem - Liquid Object Reference

Source: https://support.storeconnect.com/articles/cart-item-liquid-object-reference · Last modified 21 August 2026

## Description

A CartItem represents a single line in the customer's Cart. It always relfects a Product that the customer is purchasing, whether it be a regular product, a bundle, a subscription, or even shipping.
      Whatever the Product is, the CartItem always represents a single distinct configuration of that Product.

:::note
This object supports custom data via the `data` attribute.
:::

## Attributes

| Attribute | Type | Description |
|-----------|------|-------------|
| `bookable_event` | [BookableEvent](bookable-event-liquid-object-reference) | Returns the BookableEvent for the CartItem |
| `bookable?` | Boolean | Returns true if the CartItem is for a bookable Product |
| `bundle_has_bookable_components?` | Boolean | Returns true if the Bundle has bookable components |
| `bundle_items` | List[[CartItem](cart-item-liquid-object-reference)] | Returns the items contained in the Bundle |
| `bundle_lead?` | Boolean | Returns true if the CartItem is the lead item in a Bundle |
| `custom_forms` | List[[CustomForm](custom-form-liquid-object-reference)] | Returns a list of CustomForms for this CartItem |
| `delete_path` | String | Returns a path that can be used in a delete link to delete the CartItem from the Cart |
| `edit_bundle_path` | String | Returns a path that can be used in a link to edit CartItem |
| `has_nested_bundle_items?` | Boolean | Returns true if the Bundle has nested bundle items |
| `id` | String | Returns the unique id for this CartItem |
| `in_bundle?` | Boolean | Returns true if the CartItem is part of a Bundle |
| `max_quantity` | Number | Returns the maximum valid quantity level for this CartItem |
| `min_quantity` | Number | Returns the minimum valid quantity level for this CartItem |
| `name` | String | Returns the name of the CartItem Product |
| `pickup_options` | List[[PickupOption](pickup-option-liquid-object-reference)] | Returns a list of valid Pickup locations for this CartItem Product |
| `pricing` | [ProductPricing](product-pricing-liquid-object-reference) | Returns the Pricing for this CartItem |
| `product` | [Product](product-liquid-object-reference) | Returns the Product for this CartItem |
| `quantity` | Number | Returns the value of the Quantity attribute |
| `reserved_product?` | Boolean | Returns true if the CartItem is for a reserved Product |
| `shipping_methods` | List[String] | Returns a list of valid shipping methods for this CartItem |

## Deliveries

Attributes related to delivery windows

| Attribute | Type | Description |
|-----------|------|-------------|
| `available_delivery_dates` | List[Timestamp] | Returns available delivery dates for the CartItem |
| `available_delivery_days` | List[String] | Returns available delivery days for the CartItem |
| `available_delivery_windows` | List[[DeliveryWindow](delivery-window-liquid-object-reference)] | Returns available DeliveryWindows for the CartItem |
| `delivery_date` | Timestamp | Returns the selected delivery date for the CartItem |
| `delivery_day` | String | Returns the selected delivery day for the CartItem |
| `delivery_time` | String | Returns the selected delivery timeslot for the CartItem |

## Weights

Attributes related to weights

| Attribute | Type | Description |
|-----------|------|-------------|
| `shipping_dimensions_unit` | String | Returns the unit of the shipping dimensions of the CartItem |
| `shipping_height` | Number | Returns the shipping height of the CartItem |
| `shipping_length` | Number | Returns the shipping length of the CartItem |
| `shipping_weight` | Number | Returns the shipping weight of the CartItem |
| `shipping_weight_unit` | String | Returns the unit of the shipping weight of the CartItem |
| `shipping_width` | Number | Returns the shipping width of the CartItem |
| `total_shipping_weight` | Number | Returns the total shipping weight of the CartItem |

## Available on

- [Cart - Liquid Object Reference](cart-liquid-object-reference) — `adjustment_items`, `bookable_items`, `items`, `schedulable_items`
- [CustomForm - Liquid Object Reference](custom-form-liquid-object-reference) — `item`
- [DeliveryOptions - Liquid Object Reference](delivery-options-liquid-object-reference) — `cart_item`, `line_item`

---

## Follow StoreConnect

- [Email Newsletter](https://getstoreconnect.com/c/lp-newsletter)
- [LinkedIn Newsletter](https://www.linkedin.com/build-relation/newsletter-follow?entityUrn=7444956928444862464)
- [YouTube](https://www.youtube.com/channel/UCngKdP2x8l1wcbAKW3tvU8g)
- [LinkedIn](https://www.linkedin.com/company/storeconnect)
- [X / Twitter](https://x.com/storeconnecthq)

## Popular Links

- [Partners](https://getstoreconnect.com/partners)
- [News](https://getstoreconnect.com/articles/news)
- [Events](https://getstoreconnect.com/articles/events)
- [Feature Comparison](https://getstoreconnect.com/how-we-compare)
- [Download a free trial](https://appexchange.salesforce.com/appxListingDetail?listingId=a0N3A00000FMkeKUAT)
- [Book a Demo](https://getstoreconnect.com/contact)

## Documentation

- [Help documentation](https://support.storeconnect.com/help-documentation)
- [AI agents](https://support.storeconnect.com/ai)
- [Videos & tutorials](https://support.storeconnect.com/videos-tutorials)
- [Developer reference](https://support.storeconnect.com/developer-reference)
- [Release notes](https://support.storeconnect.com/release-notes)
- [Troubleshooting](https://support.storeconnect.com/troubleshooting)
- [Trust Center](https://trust.getstoreconnect.com/)
- [Status Page](https://status.storeconnect.com/)

## Contact

- info@getstoreconnect.com
- US +1 415 745 3230
- AUS +61 2 8365 2308

100 S Ashley Dr, Suite 600-2461
Tampa FL 33602-600 USA

Level 22, Sydney Place
180 George Street
Sydney, NSW, 2000, AUS

---

StoreConnect Support — https://support.storeconnect.com/articles/cart-item-liquid-object-reference