Component: Cart Summary

Available from: Release 106

Purpose: Display a summary of charges based on what's in the basket, including subtotal, total, and tax and discounts when applicable.

The Cart Summary component is often used with the Cart Items component to show a cohesive basket view. These components can be used on a standalone cart page, or along with the Modular Checkout in place of the Single Product Basket.

The Tax and Promo code line items are only visible in certain situations.

Promo codes

When a whole-basket promo code is applied, the promo code line will appear with the total promo code discount.

When a specific offer or add-on promo code is applied, the promo code line will not appear. Instead, a label will be displayed next to subtotal to show the amount the customer saved.

More information on promo codes can be found here: How to configure Promo Codes v2

Tax

The tax line is controlled by the “Preview tax on the order during checkout if your customer is in one of the countries below” setting in Localisation Settings. Add any country where customers should see tax calculated at checkout — for example, the US (where tax is typically exclusive and varies by state) or Germany (where VAT is inclusive). See How to configure tax behaviour for setup steps.

By default, the US and Canada are in the “Preview tax” list. Since tax in these countries requires a state or postal code to calculate, customers will initially see a placeholder message (default: “Will be calculated on the next step”) and the total will be appended with “+ tax”. Once they provide an address, they will see the tax calculation. For customers in countries not in the list, no tax line is shown at all — the sections below only apply to countries configured in the “Preview tax” list.

1. No address collected yet

This applies on a standalone Cart page before any address has been entered.

• The tax line only displays if the customer's country (from limio-country cookie) is in the “Preview tax” list.
• For US and Canada, the placeholder message is shown since state/postal code is needed to calculate tax.

2. Address collected (billing and/or delivery)

This applies on a Checkout page where address fields are present.

• If a delivery address is collected, the delivery country is used; otherwise the billing country.
• Tax is calculated once the postal code is populated. Once calculated, the tax line shows a breakdown per tax code with the rate percentage and amount from your tax provider (e.g. “Tax (+4.00%): US$47.52”).

3. Dynamic recalculation

The tax line automatically recalculates when the customer changes their country, state/region, or postal code — no page reload is required.

Props

Prop Label	Type	Default Value	Notes
Label for the subtotal row	string	Subtotal
Label for the promo code discount when applicable	string	Promo code	See Promo code section above.
Label for tax amount when applicable	string	Tax	See Tax section above.
Message to display when tax is not calculated yet	string	Will be calculated on the next step	See Tax section above.
Label for the total row	string	Total
Message on total when tax is not calculated yet	string	+ tax	See Tax section above.
Tax tooltip	string	empty	When populated, displays as message as a tooltip next to the tax line. When left empty, no tooltip will be displayed.