# 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](/components/component-library/cart-components/component-cart-items.md) 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](/components/component-library/legacy-configuration-components/component-single-product-basket.md). {% embed url="" %} 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. | --- # Agent Instructions: Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://docs.limio.com/components/component-library/cart-components/component-cart-summary.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.