> For the complete documentation index, see [llms.txt](https://docs.b2bridge.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.b2bridge.io/b2bridge-tax-exempt/tax-display.md).

# Tax Display

Tax Display allows you to show prices with tax (tax-inclusive), without tax (tax-exclusive), or both across your Shopify storefront based on who is shopping and where they are located.

### Key Capabilities

* **Target Specific Customers:** Create rules for all customers, customers with specific tags (e.g., `wholesale`, `vip`), or specific customer emails.
* **Flexible Display Modes:** Display tax-inclusive price only, tax-exclusive price only, or both prices side-by-side with customizable labels and primary highlight options.
* **Specific Page Locations:** Choose where tax display rules apply (Home page, Product pages, Collection pages, Cart page, or Search results).
* **Product Targeting:** Apply rules to all products or select specific products and collections.

### How to Set Up Tax Display Rules

#### Step 1: Create a new rule

1. In your B2Bridge VAT/Tax Exemption & Display admin, go to **Tax display** in the left navigation (or **Tax display setup** button in dashboard).

<figure><img src="https://1774158454-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FkrZUqVcl0G5WNTJjB470%2Fuploads%2FmAEXKNPEIaNyw7QZNU0w%2Fimage.png?alt=media&amp;token=02325947-4260-4899-8fa3-46c172cda9f7" alt=""><figcaption></figcaption></figure>

2. Click **Create your first display rule**

<figure><img src="https://1774158454-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FkrZUqVcl0G5WNTJjB470%2Fuploads%2FC0U4nNMXSldZPqJ6TzNh%2Fimage.png?alt=media&amp;token=d259eae2-9167-4b9e-9637-195ef0db64cc" alt=""><figcaption></figcaption></figure>

#### Step 2: Configure General Info & Priority

1. **Rule Name:** Enter a clear, descriptive name for internal reference (e.g., *EU B2B Tax Rule* or *Wholesale Tax Excluded*).
2. **Priority:** Set the priority level for this rule using numbers (`0`, `1`, `2`...).
3. **Status:** Select the Rule enabled checkbox to make the rule active once saved.

<figure><img src="https://1774158454-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FkrZUqVcl0G5WNTJjB470%2Fuploads%2FZ503yYI46gfS0WwEGTUb%2Fimage.png?alt=media&amp;token=c36d1533-7a4e-47fb-ac1c-a9ab8ddc9943" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
Note: Lower numbers take precedence (e.g., priority `0` runs before priority `1`).
{% endhint %}

#### Step 3: Select Target Audience (Who sees it)

Choose which store visitors will see prices modified by this rule:

* **All customers:** Applies to every visitor on your store.

<figure><img src="https://1774158454-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FkrZUqVcl0G5WNTJjB470%2Fuploads%2FP8f1v5hi4CVjQ8pEw3my%2Fimage.png?alt=media&amp;token=637072d3-48d8-475e-a258-e337bc6d256e" alt=""><figcaption></figcaption></figure>

* **Customers with specific tags:** Enter specific customer tags (e.g., `b2b`, `wholesale`). Only logged-in customers with these tags will see this pricing format.

<figure><img src="https://1774158454-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FkrZUqVcl0G5WNTJjB470%2Fuploads%2FMHWAVngwdXB28jEsNk6n%2Fimage.png?alt=media&amp;token=edfed194-256d-498a-9a63-d4b061c3125d" alt=""><figcaption></figcaption></figure>

* **Specific customer emails:** Search and pick specific customer accounts.

<figure><img src="https://1774158454-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FkrZUqVcl0G5WNTJjB470%2Fuploads%2FdI0AI9JMVEzJR0756G5o%2Fimage.png?alt=media&amp;token=24b07ef8-7fa2-4383-bd9e-9a2bbc578478" alt=""><figcaption></figcaption></figure>

#### Step 4: Select Products (Which products)

Define which catalog items follow this tax display rule:

* **All products:** Applies the rule across your entire store catalog.
* **Specific products / Collections:** Choose specific products or collections to limit where this rule takes effect.

<figure><img src="https://1774158454-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FkrZUqVcl0G5WNTJjB470%2Fuploads%2FJ3cPvKw96fUf7PaghYZD%2Fimage.png?alt=media&amp;token=3d348c82-df11-484a-880d-8282002f5ee9" alt=""><figcaption></figcaption></figure>

#### Step 5: Configure Pricing Format (How prices show)

Customize how the prices are calculated and presented to your shoppers:

1. **Display mode:**
   * **Both prices (incl. + excl. tax):** Displays both the tax-inclusive and tax-exclusive prices side-by-side.
   * **Tax-included price only:** Shows only the tax-inclusive price and hides the tax-exclusive price.
   * **Tax-excluded price only:** Shows only the tax-exclusive price and hides the tax-inclusive price.
2. **Primary price:** Select which price appears larger/more prominent (*Tax-excluded* or *Tax-included*).
3. **Custom Labels:** Enter custom text to identify each price type (e.g., `incl. VAT`, `excl. VAT`, or `+ Tax`).
4. **Visual Styling:** Set the secondary price font scale ratio (e.g., `0.85`) and pick custom text colors to match your theme.

<figure><img src="https://1774158454-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FkrZUqVcl0G5WNTJjB470%2Fuploads%2FczjMyUebcrfr1g9VpdU0%2Fimage.png?alt=media&amp;token=9cb7bb68-905a-400d-b339-db03537aa877" alt=""><figcaption></figcaption></figure>

#### Step 6: Choose Storefront Placement (Where it runs)

Check the boxes for all page types where this tax display rule should apply:

1. **Home page**

<figure><img src="https://1774158454-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FkrZUqVcl0G5WNTJjB470%2Fuploads%2F7kkbZDNXrMo3p3JJ3N3E%2Fimage.png?alt=media&amp;token=ea844800-256c-4a83-8baf-b14b90bd7ec4" alt=""><figcaption></figcaption></figure>

2. **Product pages**

<figure><img src="https://1774158454-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FkrZUqVcl0G5WNTJjB470%2Fuploads%2FE2GOdvZX9ABh50mbjfGx%2Fimage.png?alt=media&amp;token=c54470fc-6b99-4a13-809b-5e0de8867fd7" alt=""><figcaption></figcaption></figure>

3. **Collection pages**

<figure><img src="https://1774158454-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FkrZUqVcl0G5WNTJjB470%2Fuploads%2FjHYGMQQmoU79cxzgZiht%2Fimage.png?alt=media&amp;token=fc63d774-4945-47d6-b0e7-9bfdd877daa1" alt=""><figcaption></figcaption></figure>

4. **Cart page**

<figure><img src="https://1774158454-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FkrZUqVcl0G5WNTJjB470%2Fuploads%2FEupmelcnYoll1QNw2nFI%2Fimage.png?alt=media&amp;token=e154eb61-2a62-428f-b8f3-71c060042fe4" alt=""><figcaption></figcaption></figure>

5. **Search results**

   <figure><img src="https://1774158454-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FkrZUqVcl0G5WNTJjB470%2Fuploads%2FLIOyMJfyq6xUW1xvfso3%2Fimage.png?alt=media&amp;token=7b0a01b2-cdba-44f7-aff2-577947755e9b" alt=""><figcaption></figcaption></figure>

#### Step 7: Save and Verify

1. Click **Save** in the top right corner.
2. Visit your storefront (or use a test account with matching customer tags) to verify that the prices and tax labels render as expected.

### How Tax Calculation Works

B2Bridge calculates price displays using tax rates synced from your store. Ensure your rates are synced under **Tax rates** so price calculations remain 100% accurate across all display locations.

<figure><img src="https://1774158454-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FkrZUqVcl0G5WNTJjB470%2Fuploads%2FovG9cfq5C3IIQGpBtuxx%2Fimage.png?alt=media&amp;token=24e1aab0-51ec-4a94-b640-da1100c59199" alt=""><figcaption></figcaption></figure>

{% hint style="success" %}

### Need Help?

If you have questions or run into issues while using any feature, we're here to help.

* 💬 **Start a** [**Live Chat** with our support team](https://go.crisp.chat/chat/embed/?website_id=a59f354c-f51f-4f84-ae9a-c0e8dd69d2e5) directly from your B2Bridge dashboard.
* 📧 **Email us at** [**support@b2bridge.io**](mailto:support@b2bridge.io) and we'll get back to you as soon as possible.
  {% endhint %}
