# Cart - Liquid Object Reference Source: https://support.storeconnect.com/articles/cart-liquid-object-reference ยท Last modified 21 August 2026 ## Description The Cart object represents a shopping cart for a customer's purchasing session. It holds the items that the customer is intending to purchase. :::note This object supports custom data via the `data` attribute. ::: ## Attributes | Attribute | Type | Description | |-----------|------|-------------| | `adjustment_items` | List[[CartItem](cart-item-liquid-object-reference)] | Returns a list of adjustment CartItems in this Cart | | `all_vouchers` | List[[AppliedVoucher](applied-voucher-liquid-object-reference)] | Returns a list of all vouchers for this Cart | | `applied_credits` | List[[AppliedCredit](applied-credit-liquid-object-reference)] | Returns a list of AppliedCredits for this Cart | | `applied_vouchers` | List[[AppliedVoucher](applied-voucher-liquid-object-reference)] | Returns a list of AppliedVouchers for this Cart | | `billing_address` | [Address](address-liquid-object-reference) | Returns the billing Address for this Cart | | `bookable_cart_items_valid_until` | Timestamp | Returns the timestamp after which the Booking Timer is expired | | `bookable_items` | List[[CartItem](cart-item-liquid-object-reference)] | Returns a list of CartItems in this Cart which are for Bookable products | | `bookable_line_items_valid_until` | Timestamp | **Deprecated**: Returns the timestamp after which the Booking Timer is expired | | `bookable?` | Boolean | Returns true if the Cart contains any Bookable products | | `cache_key` | String | Returns a key that can be used for caching. | | `contact` | [Contact](contact-liquid-object-reference) | Returns the Contact for this Cart | | `created_at` | Timestamp | Returns the date and time when the Cart was created | | `currency_code` | String | Returns currency used for this Cart | | `currency_payment_required?` | Boolean | Returns true if the Cart requires a currency amount to be charged at checkout | | `custom_forms` | List[[CustomForm](custom-form-liquid-object-reference)] | Returns a list of CustomForms for this Cart | | `id` | String | Returns the unique id for this Cart | | `item_count` | Number | Returns the total number of items in this Cart | | `items` | List[[CartItem](cart-item-liquid-object-reference)] | Returns a list of CartItems in this Cart | | `payment_provider` | [PaymentProvider](payment-provider-liquid-object-reference) | Returns selected PaymentProvider for this Cart, defaults to first available | | `payment_surcharge_values` | List[[Surcharge](surcharge-liquid-object-reference)] | Returns a list of Surcharges that might be applied to this Cart | | `pickup_options` | List[[PickupOption](pickup-option-liquid-object-reference)] | Returns a list of Pickup options for this Cart | | `points_payment_required?` | Boolean | Returns true if the Cart requires a points amount to be charged at checkout | | `promotions` | List[[Promotion](promotion-liquid-object-reference)] | Returns a list of Promotions that have been applied to this Cart | | `quotable?` | Boolean | Returns true if the Cart contains any CartItems that allow quotes | | `require_delivery_method?` | Boolean | Returns true if the Cart requires a delivery method to be selected at checkout | | `schedulable_items` | List[[CartItem](cart-item-liquid-object-reference)] | Returns a list of CartItems in this Cart which are for products which can be scheduled for delivery | | `select_path` | String | Returns the path to select this Cart | | `shipping_address` | [Address](address-liquid-object-reference) | Returns the shipping Address for this Cart | | `shipping_cost` | Number | Returns the shipping cost for this Cart | | `shipping_provider_service_name` | String | Returns the name of the shipping provider service for this Cart | | `shipping_rates` | List[[ShippingRate](shipping-rate-liquid-object-reference)] | Returns a list of ShippingRates for items in this Cart | | `sub_total` | Number | Returns the sub total price for all CartItems, excluding any taxes where tax is exclusive | | `sub_total_points` | Number | Returns the sub total points price for all CartItems | | `taxes` | List[[Tax](tax-liquid-object-reference)] | Returns a list of CartItems in this Cart | | `test_order?` | Boolean | Returns true if the Cart represents a test order | | `total` | Number | Returns the total price including tax for this Cart | | `total_deposit` | Number | Returns the total deposit amount for all CartItems in this Cart | | `total_deposit_points` | Number | Returns the total deposit points amount for all CartItems in this Cart | | `total_fixed_term_subscriptions` | Number | Returns the total price for fixed term subscriptions in this Cart | | `total_fixed_term_subscriptions_points` | Number | Returns the total points price for fixed term subscriptions in this Cart | | `total_non_subscriptions` | Number | Returns the total price for non-subscription items in this Cart | | `total_non_subscriptions_points` | Number | Returns the total points price for non-subscription items in this Cart | | `total_paid` | Number | Returns the total amount already paid for this Cart | | `total_paid_points` | Number | Returns the total points amount already paid for this Cart | | `total_payable` | Number | Returns the total amount to be paid at checkout for this Cart | | `total_payable_points` | Number | Returns the total points amount to be paid at checkout for this Cart | | `total_points` | Number | Returns the total points price for this Cart | | `total_shipping_weight_kg` | Number | Returns the total shipping weight of the Cart in kilograms | | `total_shipping_weight_lb` | Number | Returns the total shipping weight of the Cart in pounds | | `total_subscriptions` | Number | Returns the total price for subscription items in this Cart | | `total_subscriptions_points` | Number | Returns the total points price for subscription items in this Cart | | `total_tax` | Number | Returns the total tax for this Cart | ## Available on - [Contact - Liquid Object Reference](contact-liquid-object-reference) โ€” `carts` - [Global - Liquid Object Reference](global-liquid-object-reference) โ€” `current_cart` --- ## 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-liquid-object-reference