Skip to Content
ReferenceLiquid ReferenceObjectsStoreCart

Cart

The cart object represents the current shopping cart in the store. It provides access to cart items, totals, discounts, shipping, and payment information.

Usage Example

{%- comment -%} Show cart summary and list items {%- endcomment -%}
<p>You have {{ cart.item_count }} items in your cart.</p>
<ul>
  {% for item in cart.items %}
    <li>
      <strong>{{ item.product.title }}</strong> × {{ item.quantity }}<br>
      Price: {{ item.line_price | money }}
    </li>
  {% endfor %}
</ul>
<p>Subtotal: {{ cart.subtotal | money }}</p>
<p>Shipping: {{ cart.shipping_price | money }}</p>
<p>Total: <strong>{{ cart.total | money_with_currency }}</strong></p>
 
{% if cart.applicable_for_free_shipping %}
  <p>Congratulations! Your order qualifies for free shipping.</p>
{% elsif cart.calc_free_shipping_limit %}
  <div class="free-shipping-info">
    <strong>{{ cart.calc_free_shipping_limit.title }}</strong><br>
    <span>{{ cart.calc_free_shipping_limit.description }}</span><br>
    <span>Add {{ cart.calc_free_shipping_limit.amount_to_limit | money }} more (limit: {{ cart.calc_free_shipping_limit.limit_amount | money }}) for free shipping.</span>
  </div>
{% endif %}

Properties

applicable_for_free_shipping

Returns true if the current cart is applicable for free shipping.

calc_free_shipping_limit

Returns information about the free shipping limit if available, otherwise returns false. When available, this object contains:

  • title: The title for the free shipping offer (e.g. “Free shipping!”).
  • description: A description of the free shipping offer (e.g. “Spend a bit more to get free shipping”).
  • limit_amount: The minimum cart total required for free shipping.
  • amount_to_limit: The remaining amount needed to reach the free shipping threshold.

Example usage:

{% if cart.calc_free_shipping_limit %}
  <div>
    <strong>{{ cart.calc_free_shipping_limit.title }}</strong><br>
    <span>{{ cart.calc_free_shipping_limit.description }}</span><br>
    <span>Add {{ cart.calc_free_shipping_limit.amount_to_limit | money }} more (limit: {{ cart.calc_free_shipping_limit.limit_amount | money }}) for free shipping.</span>
  </div>
{% endif %}

currency

Returns the currency for this cart.

delivery_time_in_days

Returns the estimated delivery time in days.

discounts

Lists applied discounts for this cart.

expires

If there is a reservation time applied to this cart, returns the timestamp when the reservation expires.

id

Returns the id of the cart.

item_count

Returns the total amount of items in the cart.

items

Lists added items to this cart.

payment_fee

Returns the total payment fees for this cart.

payment_methods

Lists selected payment methods for this cart.

shipping_methods

Lists selected shipping methods for this cart.

shipping_price

Returns the total shipping costs for this cart.

subtotal

Returns the subtotal for this cart.

tax

Returns the total tax included.

tax_free

Returns the tax free price.

total

Returns the total of the cart.

weight_in_grams

Returns the total cart weight in grams.

Last updated on
BlogCatalog