---
title: "Tax Profiles"
description: "Tax profiles (also called tax classes) group tax rules together and are assigned to products."
url: "https://docs.j2commerce.com/v6/localization/tax-profiles"
markdown_url: "https://docs.j2commerce.com/v6/localization/tax-profiles.md"
last_updated: "2026-10-23T02:33:38+00:00"
version: "J2Commerce 6"
breadcrumbs:
  - title: "Home"
    url: "https://docs.j2commerce.com/"
  - title: "J2Commerce 6"
    url: "https://docs.j2commerce.com/v6"
  - title: "Localization"
    url: "https://docs.j2commerce.com/v6/localization"
  - title: "Tax Profiles"
    url: "https://docs.j2commerce.com/v6/localization/tax-profiles"
---

# Tax Profiles

Tax profiles (also called tax classes) group tax rules together and are assigned to products. When a customer purchases a product, J2Commerce calculates tax based on the product's tax profile, the customer's location (geozone), and the applicable tax rates. This allows different products to have different tax rates—essential for stores selling both taxable and tax-exempt items, or items with reduced tax rates.

> **Tip:** **IMPORTANT:** You have to create a **Tax Rate** and the **Geozones** before you can create a Tax Profile. If you haven't set up your tax rates or need help, go to the Tax Rate and Geozone Documentations

## Requirements

- PHP 8.3.0+
- Joomla 6.x
- J2Commerce 6.x

## Locating Tax Profiles

Tax Profiles are managed from the J2Commerce Dashboard.

There are **two** ways you can access the Tax Profiles.

**Option A:** Go to the **J2Commerce** icon at the top right corner **-> Localization -> Tax Profiles**

**Option B:** Go to **Components** on the left sidebar **-> J2Commerce -> Dashboard -> Localization -> Tax Profiles**

![Tax Profiles list opened via the J2Commerce menu: Components, J2Commerce, Dashboard, Localization and Tax Profiles highlighted, listing TN Tax](https://docs.j2commerce.com/images/docs/shared/tax-profiles.webp)

## Tax Profile List

The Tax Profiles list displays all tax profiles configured in your store. Each profile shows:

**Checkbox:** Select rates to activate the batch actions button.

**Tax Profile Name:** The display name of the tax profile.

**Description:** A brief description of the tax profile's purpose.

**Status:** Published (green check) or Unpublished (red X).

**ID:** The individual ID number

## Adding a New Tax Profile

1. Click the **New** button in the toolbar.
2. Fill in the tax profile details (see Configuration below).
3. Click **Save** or **Save & Close**.

![Edit Tax Profile TN Tax, Tax Rules tab: Tax Rate Tennessee Sales Tax (9.250%), Address Type Shipping Address, Delete and Add Tax Rule buttons](https://docs.j2commerce.com/images/docs/shared/tax-profiles-config.webp)

## Configuration

**Tax Profile Name:** A descriptive name for this tax profile. **Example:** `Standard VAT` or `TN Tax`

**Status:** Set to **Published** to make the profile available for use.

![Tax Profiles list with the published Status check and the TN Tax profile name outlined, with the J2Commerce navigation bar above](https://docs.j2commerce.com/images/docs/shared/tax-profiles-enable.webp)

## How Tax Profiles Work

Tax profiles act as a bridge between products and tax rates:

1. **Create Tax Profiles** — Define profiles for different product categories (e.g., "Standard VAT", "Reduced VAT", "Zero Rate", "Exempt").
2. **Create Geozones** — Define geographic zones for tax jurisdictions (e.g., "UK", "EU", "California").
3. **Create Tax Rates** — Define tax percentage rates for each geozone/profile combination.
4. **Assign to Products** — Products are assigned a tax profile; when purchased, the correct tax rate is calculated.

### Tax Profile Hierarchy

```mermaid
graph TD
    A[Product] --> B[Tax Profile]
    B --> C[Tax Rate 1: UK - 20%]
    B --> D[Tax Rate 2: EU - 19%]
    B --> E[Tax Rate 3: US - 0%]
    C --> F[Geozone: UK]
    D --> G[Geozone: EU]
    E --> H[Geozone: Rest of World]
```

*Assign to Products — Products are assigned a tax profile; when purchased, the correct tax rate is calculated.*

## Common Tax Profiles

Most stores need a few standard tax profiles:

| Tax Profile | Description | Use Case |
| --- | --- | --- |
| **Standard VAT/GST** | Standard rate tax for most products. | General merchandise, electronics, clothing. |
| **Reduced VAT** | Lower rate for essential items. | Food, books, children's clothing. |
| **Zero Rate** | Zero tax rate but still tracked. | Exports, certain medical supplies. |
| **Exempt** | No tax applied, not tracked. | Educational materials, charities. |
| **Not Taxable** | No tax applied. | Digital downloads in some jurisdictions. |

## Assigning Tax Profiles to Products

After creating tax profiles, assign them to products:

1. Go to **J2Commerce** **->** **Products**.
2. Edit a product.
3. **J2Commerce** tab **->** **General** tab
4. In the product settings, find the **Tax Profile** field.
5. Select the appropriate tax profile from the dropdown.
6. Save the product.

![Product edit, General tab highlighted: SKU ga-cb, Brand and Vendor empty, and the Tax Profile field outlined and set to TN Tax](https://docs.j2commerce.com/images/docs/shared/tax-profiles-product.webp)

## Frontend View

![Storefront checkout order summary with the tax line TN Tax (9.25%) $0.62 outlined between shipping $4.78 and the Total $12.15](https://docs.j2commerce.com/images/docs/shared/tax-profiles-checkout.webp)

## Tax Rate Assignment

Tax profiles themselves don't contain rates. Instead, you create tax rates that link:

- A **Tax Profile** (e.g., "Standard VAT")
- A **Geozone** (e.g., "UK")
- A **Tax Percentage** (e.g., 20%)

See [Tax Rates](https://docs.j2commerce.com/index.php?option=com_content&view=article&id=8&catid=53) for detailed configuration.

## Tips

- **Create meaningful names** — Use names that clearly indicate the tax category (e.g., "Standard Rate", "Reduced Rate", "Digital Goods").
- **Document your setup** — Keep notes on which products use which profiles and why.
- **Consider future changes** — Tax rates may change; having profiles means you only update rates, not products.
- **Create an "Exempt" profile** — Useful for customers with tax exemption certificates.
- **Sync with geozones** — Ensure your tax profiles have corresponding tax rates for each geozone you sell to.

## Example Configuration

A UK-based store selling internationally:

### Tax Profiles

**Standard VAT:** Standard 20% VAT rate for most products

**Reduced VAT:** Reduced 5% VAT rate for books, children's clothing

**Zero Rate:** 0% for exports and exempt items

**Not Taxable:** No tax for digital services outside EU

### Tax Rates (per profile)

For **Standard VAT**: Below shows the Geozone and its rate

- **United Kingdom:** 20%
- **EU Member States:** Varies by country
- **Rest of World:** 0%

For **Reduced VAT**: Below shows the Geozone and its rate

- **United Kingdom:** 5%
- **EU Member States:** Varies (often 5-7%)

For **Zero Rate**:Below shows the Geozone and its rate

- **All Geozones:** 0%

## Troubleshooting

### Tax Not Calculating on Checkout

**Cause:** Product has no tax profile assigned, or the tax profile has no tax rates for the customer's geozone.

**Solution:**

1. Edit the product and verify a **Tax Profile** is assigned.
2. Go to **J2Commerce -> Localization -> Tax Rates**.
3. Check that tax rates exist for the product's tax profile and the customer's geozone.
4. Verify the geozone includes the customer's country/zone.

### Wrong Tax Rate Applied

**Cause:** Multiple tax rates matching the customer's location, or incorrect geozone assignment.

**Solution:**

1. Review your geozones to ensure no overlap in country/zone rules.
2. Check tax rates for the applicable tax profile.
3. Verify each tax rate is linked to the correct geozone.
4. Ensure only one tax rate per profile/geozone combination.

### Products Missing Tax Profile

**Cause:** Products created without a tax profile assignment.

**Solution:**

1. Go to **J2Commerce ->** **Products**.
2. Use the filter to find products without a tax profile.
3. Bulk edit products to assign the default tax profile.
4. Set a default tax profile in the configuration for new products.

### Tax Profile Not Appearing in Product Edit

**Cause:** Tax profile is unpublished or does not exist.

**Solution:**

1. Go to **J2Commerce** **-> Localization ->** **Tax Profiles**.
2. Verify the tax profile exists and is published (green check).
3. Create a new tax profile if needed.