Shopify Liquid MCP Server

# Liquid Objects: Cart A customer's cart. ## Properties ### attributes Additional attributes entered by the customer with the cart. To learn more about capturing cart attributes, refer to the [cart template](https://shopify.dev/themes/architecture/templates/cart#support-cart-notes-and-attributes). **Example: Capture cart attributes** To capture a cart attribute, include an HTML input with an attribute of `name="attributes[attribute-name]"` within the cart `<form>`. ```liquid <label>What do you want engraved on your cauldron?</label> <input type="text" name="attributes[cauldron-engraving]" value="{{ cart.attributes.cauldron-engraving }}" /> ``` **Tip:** You can add a double underscore `__` prefix to an attribute name to make it private. Private attributes work like other cart attributes, except they cannot be read from Liquid or the Ajax API. Use them for data that doesn't affect page rendering for more effective caching. ### cart_level_discount_applications Array of [discount_application](https://shopify.dev/docs/api/liquid/objects/discount_application) The cart-specific discount applications for the cart. **Example: Display cart-level discount applications** ```liquid {% for discount_application in cart.cart_level_discount_applications %} Discount name: {{ discount_application.title }} Savings: -{{ discount_application.total_allocated_amount | money }} {% endfor %} ``` ### checkout_charge_amount [number](https://shopify.dev/docs/api/liquid/basics#number) The amount that the customer will be charged at checkout in the currency's subunit. The value appears in the customer's local (presentment) currency. For currencies without subunits like JPY and KRW, tenths and hundredths of a unit are appended. For example, 1000 Japanese yen displays as 100000. **Tip:** Use [money filters](https://shopify.dev/docs/api/liquid/filters/money-filters) to output a formatted price. ### currency The currency of the cart. If the store uses multi-currency, this matches the customer's local (presentment) currency. Otherwise, it matches the store currency. **Tip:** Output available store currencies using [`shop.enabled_currencies`](https://shopify.dev/docs/api/liquid/objects/shop#shop-enabled_currencies). ### discount_applications Array of [discount_application](https://shopify.dev/docs/api/liquid/objects/discount_application) The discount applications for the cart. **Example: Display discount applications** ```liquid {% for discount_application in cart.discount_applications %} Discount name: {{ discount_application.title }} Savings: -{{ discount_application.total_allocated_amount | money }} {% endfor %} ``` ### duties_included [boolean](https://shopify.dev/docs/api/liquid/basics#boolean) Returns `true` if duties are included in product prices. Returns `false` if not. ### empty? [boolean](https://shopify.dev/docs/api/liquid/basics#boolean) Returns `true` if there are no items in the cart. Returns `false` if there are items. ### item_count [number](https://shopify.dev/docs/api/liquid/basics#number) The number of items in the cart. ### items Array of [line_item](https://shopify.dev/docs/api/liquid/objects/line_item) The line items in the cart. ### items_subtotal_price [number](https://shopify.dev/docs/api/liquid/basics#number) The total price of all items in the cart in the currency's subunit, after any line item discounts. This excludes taxes (unless included in prices), cart discounts, and shipping costs. The value appears in the customer's local (presentment) currency. For currencies without subunits, tenths and hundredths of a unit are appended. **Tip:** Use [money filters](https://shopify.dev/docs/api/liquid/filters/money-filters) to output a formatted amount. ### note [string](https://shopify.dev/docs/api/liquid/basics#string) Additional information captured with the cart. **Example: Capture cart notes** Include an HTML input such as a `<textarea>` with an attribute of `name="note"` within the cart `<form>`: ```liquid <label>Gift note:</label> <textarea name="note"></textarea> ``` **Note:** Only one instance of `{{ cart.note }}` should appear on the cart page. Multiple instances will submit the one latest in the DOM. ### original_total_price [number](https://shopify.dev/docs/api/liquid/basics#number) The total price of all items in the cart in the currency's subunit, before discounts. The value appears in the customer's local (presentment) currency. For currencies without subunits, tenths and hundredths of a unit are appended. **Tip:** Use [money filters](https://shopify.dev/docs/api/liquid/filters/money-filters) to output a formatted amount. ### requires_shipping [boolean](https://shopify.dev/docs/api/liquid/basics#boolean) Returns `true` if any products in the cart require shipping. Returns `false` if not. ### taxes_included [boolean](https://shopify.dev/docs/api/liquid/basics#boolean) Returns `true` if taxes are included in product prices. Returns `false` if not. This can be set in a store's [tax settings](https://www.shopify.com/admin/settings/taxes). If the store includes or excludes tax based on the customer's country, the value reflects that country's requirements. ### total_discount [number](https://shopify.dev/docs/api/liquid/basics#number) The total amount of all discounts (total savings) for the cart in the currency's subunit. The value appears in the customer's local (presentment) currency. For currencies without subunits, tenths and hundredths of a unit are appended. **Tip:** Use [money filters](https://shopify.dev/docs/api/liquid/filters/money-filters) to output a formatted amount. ### total_price [number](https://shopify.dev/docs/api/liquid/basics#number) The total price of all items in the cart in the currency's subunit, after discounts. The value appears in the customer's local (presentment) currency. For currencies without subunits, tenths and hundredths of a unit are appended. **Tip:** Use [money filters](https://shopify.dev/docs/api/liquid/filters/money-filters) to output a formatted amount. ### total_weight [number](https://shopify.dev/docs/api/liquid/basics#number) The total weight of all items in the cart in grams. **Tip:** Use the [`weight_with_unit`](https://shopify.dev/docs/api/liquid/filters/weight_with_unit) filter to format the weight in the store's format or override the default unit. ## Deprecated Properties ### discounts Array of [discount](https://shopify.dev/docs/api/liquid/objects/discount) **[Deprecated]** The discounts applied to the cart. **Deprecation Notice:** Not all discount types and details are available. Use [`cart.discount_applications`](https://shopify.dev/docs/api/liquid/objects/cart#cart-discount_applications) instead.