# Configure Tax Behaviour

**Purpose:** Use these settings to determine if prices are displayed with or without tax added for certain territories.

**Steps:**

1: Click on the profile icon in the top-right corner of the app.

2: Click on the **Developer** option in the dropdown.

<figure><img src="https://2981049874-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fxxxhzz4ER0TH1oIFAttf%2Fuploads%2FPiAvstCWsZdlGXawWpe2%2Fimage.png?alt=media&#x26;token=27a28ab7-cbae-45ab-a6e6-afa7aa65c192" alt=""><figcaption></figcaption></figure>

3: Click **General Settings**, then **Localisation** and find the section named **Tax Behaviour**.

<figure><img src="https://2981049874-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fxxxhzz4ER0TH1oIFAttf%2Fuploads%2FYETYqMkWghhESikv9QYJ%2Fimage.png?alt=media&#x26;token=5b95e3b4-a421-4889-b306-126bd6ab6dd8" alt=""><figcaption></figcaption></figure>

4: Don't forget to save the changes by clicking the **Save** button in the top-right of the page.

5: If you have just configured this feature and would like to see it on published pages, the relevant pages must be rebuilt and republished to utilise the changes.

### Configure tax in acquisition components

The [Cart Summary](https://docs.limio.com/components/component-library/cart-components/component-cart-summary) component uses the **"Preview tax on the order during checkout"** setting to display and calculate tax during checkout. Add any country where you want customers to see a tax preview in the Cart Summary — for example, the US (tax-exclusive) or Germany (tax-inclusive with VAT).

<div data-with-frame="true"><figure><img src="https://2981049874-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fxxxhzz4ER0TH1oIFAttf%2Fuploads%2FdDaKT1Z3LVZP1AMGwkv1%2FScreenshot%202026-03-31%20at%2018.43.07.png?alt=media&#x26;token=8f279c53-0f0e-4de9-9146-26de5811eb79" alt=""><figcaption></figcaption></figure></div>

The Cart Summary component documentation explains how tax display behaves across different checkout states, including:

* Before an address is collected (based on the customer's `lmo_country` cookie)
* After billing or delivery address is populated (calculated from postal code)
* Dynamic recalculation when the customer changes address fields

See the full breakdown in the [Cart Summary component documentation](https://docs.limio.com/components/component-library/cart-components/component-cart-summary).

### Configure tax in self-service components

For the following components:

* [Payments Table](https://docs.limio.com/components/component-library/standard-components/component-payments-table)
* [Switch Subscription](https://docs.limio.com/components/component-library/standard-components/component-switch-subscription)
* [Cancel Save Offer](https://docs.limio.com/components/component-library/standard-components/component-cancel-save-offer)
* [Order Change Success](https://docs.limio.com/components/component-library/standard-components/component-order-change-success)
* [Orders Table](https://docs.limio.com/components/component-library/standard-components/component-orders-table)
* [Subscription Description](https://docs.limio.com/components/component-library/standard-components/component-subscription-description)
* [Subscription Info](https://docs.limio.com/components/component-library/standard-components/component-subscription-info)
* [Change Order Table](https://docs.limio.com/components/component-library/standard-components/component-order-change-table)

If the customer's billing address matches with a country listed in the section "**Display the tax-exclusive price as the final price on self-service components if your customers are in one of these countries**", then the prices in the components listed originally will be displayed without tax added.

The default options here are the United States of America and Canada, but you may want to remove all countries entirely depending on your tax requirements.

### Configure tax in Apple Pay modal

This impacts how prices are displayed in any Cart or Checkout components.

**Steps**:

1: Click on the profile icon in the top-right corner of the app.

2: Click on the **Developer** option in the dropdown.

<figure><img src="https://2981049874-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fxxxhzz4ER0TH1oIFAttf%2Fuploads%2Fht6PtFqvlNdequvJudzG%2Fimage.png?alt=media&#x26;token=7cd78fce-2d18-47fb-8df1-f0d275221583" alt=""><figcaption></figcaption></figure>

3: Click **General Settings**, then **Localisation** and find the section named **Tax Behaviour**.

<figure><img src="https://2981049874-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fxxxhzz4ER0TH1oIFAttf%2Fuploads%2FUdqLfRffh7yV7qM3tSui%2Fimage.png?alt=media&#x26;token=e5e226cf-8d30-46ca-82de-b8457bcf006b" alt=""><figcaption></figcaption></figure>

If the customer's Apple Pay address matches one of the countries in "Preview tax on the order during checkout if your customer is in one of the countries below", then tax will be included in the Apple Pay modal.

4: Don't forget to save the changes by clicking the **Save** button in the top-right of the page.

5: If you have just configured this feature and would like to see it on published pages, the relevant pages must be rebuilt and republished to utilise the changes.