# 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](https://docs.limio.com/components/component-library/cart-components/component-cart-items) 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](https://docs.limio.com/components/component-library/legacy-configuration-components/component-single-product-basket).

{% embed url="<https://69c2cf3a42a094f3cd354b8d-rfnbnfqzuj.chromatic.com/?path=/story/shop-components-cart-cart-summary--example&full=1&shortcuts=false&singleStory=true&embed=true>" %}

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](https://docs.limio.com/product/pricing/how-to-configure-and-implement-promo-codes)

**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](https://docs.limio.com/product/settings/how-to-set-up-localisation). 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](https://docs.limio.com/product/settings/how-to-set-up-localisation/how-to-configure-tax-behaviour-for-tax-exclusive-countries) 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 `lmo_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. |