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