---
title: "Connecting TaxCloud to WooCommerce"
description: "The TaxCloud integration for WooCommerce provides a comprehensive sales tax management solution for your store, automating sales tax calculation, collection, and remittance across all U.S. jurisdictions."
canonical_url: "https://support.taxcloud.com/articles/connecting-taxcloud-to-woocommerce-aItekDhM9N"
md_url: "https://support.taxcloud.com/articles/connecting-taxcloud-to-woocommerce-aItekDhM9N.md"
---
# Connecting TaxCloud to WooCommerce

The TaxCloud integration for WooCommerce provides a comprehensive sales tax management solution for your store, automating sales tax calculation, collection, and remittance across all U.S. jurisdictions.

[WooCommerce Integration Modes Overview 1552x1080](https://support.taxcloud.com/api/attachments.redirect?id=1842862b-5c97-4203-9012-af76690e7d0e&start=0&end=103.914104)

# About Integration Modes

The TaxCloud WooCommerce integration offers two modes: Real-Time and Data Import. Real-Time mode (recommended) provides automated tax calculations during checkout, while Data Import mode is designed for merchants with very specific, limited needs who handle tax calculations separately.


:::tip
**Real-Time Recommended**

For most WooCommerce stores, Real-Time mode delivers the best experience with automated calculations, nexus tracking, and comprehensive compliance features. [Learn more about integration modes →]()

:::

# How the Integration Works

TaxCloud connects to your WooCommerce site using a WordPress plugin. Once installed and configured, the integration provides different capabilities depending on which mode you're using: 

| **Functionality** | **Real-Time Mode** | **Data Import Mode** |
|----|----|----|
| Sales tax calculations | **Yes** - Automated calculations at checkout | **No** - You must configure tax rates in WooCommerce |
| Order capture | **Yes** - For reporting and filing | **Yes** - For reporting and filing |
| Exempt customer support | **Yes** - [Multiple exemption options](https://support.taxcloud.com/en-us/articles/enabling-exemptions-in-woocommerce-9bSC8n71mA) | **No** - Not available in Data Import mode |
| Nexus tracking | **Yes** - Automatic monitoring | **Limited** - Tracked for reporting only. |
| Automatic rate updates | **Yes** - Always current | **No** - You maintain rates manually |

# Customer Exemptions


:::info
Note: Customer exemption features are only available in Real-Time mode. Data Import mode does not support tax exemptions.

:::

The real-time integration mode supports three different exemption configurations:


1. **No exemptions enabled**: If your store does not have tax-exempt customers, you can disable exemptions entirely to simplify tax compliance. 
2. **Exemptions enabled for specific customers**: If you sell to a specific list of tax-exempt customers, exemptions can be applied based on user roles. Note that this requires the customer to create an account and log in while shopping. 
3. **Exemptions enabled for all customers**: Customers who are not pre-approved for exemptions can submit an exemption certificate at checkout. During checkout, the customer must be logged in, select the option to add an exemption certificate, and provide their exemption information. 

For detailed instructions, see [our dedicated article on configuring WooCommerce exemptions](https://support.taxcloud.com/).

# Before you begin

Complete the following steps before you set up the integration to ensure that it works as intended.

## Complete TaxCloud setup

Your TaxCloud account must be set up so that the integration works correctly.


1. [Create a TaxCloud account](https://app.taxcloud.com/register) if you don't already have one. You must be on the [TaxCloud Premium plan](https://taxcloud.com/taxcloud-pricing/) or a free trial to use the WooCommerce integration in **Real Time** mode. Data Import mode is available on Free, Starter, and Premium plans.
2. Sign into [TaxCloud](https://app.taxcloud.com/).
3. [Complete your TaxCloud Business Profile](https://support.taxcloud.com/article/42-video-how-to-complete-your-taxcloud-business-profile).
4. [Set up your locations and states](https://support.taxcloud.com/).

## Look up Taxability Information Codes

Use our [Taxability Information Codes page to look](https://support.taxcloud.com/) up your goods/services.

* If there is one TIC that matches all the products that you sell, you can use that code as the default for the integration.
* If your goods and services don’t match one TIC, assign a specific TIC to each product in your Adobe Commerce store. In this scenario, the default TIC can be 0 (taxed) or a specific TIC.

## Set up WooCommerce

WooCommerce must be installed and configured on your WordPress site before you set up the TaxCloud for WooCommerce integration.

### Confirm the Requirements are Met

To set up the integration, you’ll need:

* An active WooCommerce store with:
  * WordPress version 4.5.0 or higher
  * WooCommerce 7.0 or higher
  * PHP version 7.4 or higher
* Administrator access to your WordPress site

### Make Sure Tax is Enabled in WooCommerce Settings

Tax must be enabled in WooCommerce for the TaxCloud plugin to function.


1. In WordPress, go to **WooCommerce > Settings > General**.
2. Under **General options**, make sure that **Enable taxes is checked**.
3. For Data Import mode users, you must [set up the tax rates manually in WooCommerce](https://woocommerce.com/document/setting-up-taxes-in-woocommerce/) or install and configure the [WooCommerce Tax plugin](https://woocommerce.com/products/tax/). 

 ![](https://support.taxcloud.com/api/attachments.redirect?id=0bf8ceb0-8498-41d8-bb0d-ecef9733dd45)

### Set Up Shipping Zones

You must have one or more shipping zones that apply to your customers. If you wish to offer the same shipping methods to all customers, a zone that covers the United States is sufficient.

To set up shipping zones, go to **WooCommerce > Settings > Shipping**.

 ![](https://support.taxcloud.com/api/attachments.redirect?id=63f9ac4b-a03e-42f9-a321-9d861238c33a)

# Step 1: Add WooCommerce to your TaxCloud account

In TaxCloud, set up the connection to WooCommerce.


1. Go to the **[Integrations](https://app.taxcloud.com/go/integrations)** page.

   Click **Add Connection**, then click **WooCommerce**.

   In the top-right corner, click **Add**.

    ![](/api/attachments.redirect?id=182da95b-b172-4514-90be-54a3f685b5b3)

   Enter the integration details.

    ![](https://support.taxcloud.com/api/attachments.redirect?id=846778c6-1da7-4104-9c93-2dcd5c89d899)

   
   1. Enter a **Name** for the integration.

      This name is used for identification purposes in TaxCloud. For example, if you have multiple integrations connected the name helps you differentiate them.
   2. Enter the **URL** of your store.
   3. Enter the **Taxability Information Code (TIC)** that best fits the goods or services that you sell so that TaxCloud can identify and properly tax items. You should have already researched TICs in [Before you begin](https://support.taxcloud.com/).
      * To search for TICs, expand **Need Help Finding your Taxability Information Code (TIC)**?
      * If there is no match, enter **0**. This will set items to "General" and always taxable.
        * OR reach out to Customer Support or your Onboarding Specialist to have a new TIC code created if none existing apply
   4. Select **Real-Time mode** (recommended) or **Data Import** mode in your TaxCloud integration settings. [Learn more about each mode →](#)
2. Click **Finish Setup**.
3. At the bottom of the page under **V1 API Key**, note the **Login ID** and **API Key**. You'll use this information later to authenticate with WooCommerce.

    ![](https://support.taxcloud.com/api/attachments.redirect?id=479924cd-4c4d-4f0c-9367-f3ff1f550ff6 " =826x708")

# Step 2: Install TaxCloud for WooCommerce on your WordPress site

The [TaxCloud for WooCommerce extension](https://woocommerce.com/products/taxcloud/) is required to use the integration.


1. Sign into your WordPress site.
2. Go to **WooCommerce > Extensions**.
3. Search for **TaxCloud**.
4. Click **TaxCloud**, then click **Add to store**.
5. Follow the instructions to add TaxCloud to your store.

 ![](https://support.taxcloud.com/api/attachments.redirect?id=038b4721-1469-4222-8567-17039d2c436a " =826x619")

# Step 3: Configure Tax Rates Based on Your Mode

Your tax rate configuration depends on which integration mode you selected:

* **Real-Time Mode:** Remove existing WooCommerce tax rates. TaxCloud handles calculations automatically, so rate tables should be empty to avoid double charging your customers. WooCommerce will display a notice if rates need to be removed, as seen below.

 ![](https://support.taxcloud.com/api/attachments.redirect?id=b34840d7-6238-4b87-b909-28821f8b1bae " =732x53")

* **Data Import Mode:** Configure and maintain WooCommerce tax rates. You're responsible for keeping these current. See [How Tax Calculations Work in Data Import Mode]() for instructions.

# Step 4: Configure TaxCloud for WooCommerce settings

Complete the following steps to set up TaxCloud for WooCommerce on your WordPress site.

## 4a: Enter your TaxCloud API credentials

Adding your API credentials allows the plugin to communicate with your TaxCloud account.


1. From your WordPress admin portal, navigate to **WooCommerce > Settings > Integrations > TaxCloud for WooCommerce**.

    ![](https://support.taxcloud.com/api/attachments.redirect?id=098a6e92-984d-41ef-8e3b-8fcb4d7138c5 " =826x362")
2. Enter your TaxCloud API credentials in **TaxCloud API ID** and **TaxCloud API Key**. You recorded these in Step 1, and you can find them again on the Integrations page.
3. Click **Verify Settings**.
4. If you see a success message, click **Save changes** at the bottom of the page. If you see a failure message, confirm that you have entered the credentials correctly and try again.

## 4b: Set your shipping origin addresses

On the same page under **Address Settings**, you should now see a list of your TaxCloud locations in the **Shipping Origin Addresses** field.

 ![](https://support.taxcloud.com/api/attachments.redirect?id=f7042158-ae5e-451d-b9f0-9c87d93d8953 " =826x161")


1. Select all of the addresses you ship your products from.
2. Click **Save changes** at the bottom of the page.

## 4c: Set the TIC for shipping

On the same page under **Advanced Settings**, set the **Shipping TIC** that best fits your shipping method. This controls how taxes are calculated for shipping.

 ![](https://support.taxcloud.com/api/attachments.redirect?id=ded3bfa1-8d11-460b-b920-a3b36b653ff3 " =722x188")

## 4d: Set up customer exemptions (Real-Time Mode integration only)

On the same page under **Exemption Settings**, configure how you want to handle exempt customers. For detailed instructions, see [our dedicated article on configuring WooCommerce exemptions](https://support.taxcloud.com/).

 ![](https://support.taxcloud.com/api/attachments.redirect?id=f866f31c-e8bf-49ea-80f7-f3588c620148 " =722x379")

# Step 5: Configure your product catalog

Set Taxability Information Codes (TICs) and and shipping origin addresses for your products.

## 5a: Set TICs for your products

If you sell products that do not fall into the category indicated by the default [TIC](https://app.taxcloud.com/tic) you set for the integration, you will need to assign appropriate TICs to these products. For your convenience, there are three ways you can assign TICs.

### Option 1: Category-level TIC assignment

To assign a TIC to all products in a category:


1. Navigate to **Products > Categories**
2. Select the category.
3. Next to **Taxability Information Code**, click Select and then choose a TIC.

    ![](https://support.taxcloud.com/api/attachments.redirect?id=b13ed2ad-d447-4cfc-9808-6bd496adc895 " =722x109")
4. Click **Save Changes**.

### Option 2: Bulk TIC assignment

To assign a TIC to a group of products:


1. Navigate to the **Products** page.

   
   1. Check the box next to the products that you'd like to assign the same TIC to.

       ![](https://support.taxcloud.com/api/attachments.redirect?id=857fbd9a-cd65-4c44-981f-a2dce149e7df " =826x424")
2. From the **Bulk Actions** menu, select **Edit**, then click **Apply**.
3. Under **Product data**, select a new **TIC**.

    ![](https://support.taxcloud.com/api/attachments.redirect?id=f3694941-8fd0-4a95-bebf-92d05a49ce30 " =826x607")
4. Click **Update**.

### Option 3: Product-level TIC assignment

To assign a TIC to a single product:


1. Navigate to the **Products** page.
2. Edit the product.
3. Scroll to the **Product data** box.

    ![](https://support.taxcloud.com/api/attachments.redirect?id=ecdf55af-f870-4556-b845-a732e37a9981 " =929x376")
4. On the General tab, select a new **TIC**.
5. Click **Update** in the Publish box.

## 5b: (Multi-state businesses only) Select shipping origin addresses

If you ship items from more than one business location, you also need to indicate the shipping origin addresses for each of your items. This is important because a handful of states use the origin address to determine the sales tax rate to apply.

By default, all products in your store are configured to ship from the **Shipping Origin Addresses** you previously configured in [Step 4b](https://support.taxcloud.com/).

If you need to change the default origin addresses for a product:


1. Navigate to the **Products** page.
2. Edit the product.
3. Scroll to the **Product data** box.
4. Go to the Shipping tab.
5. Add or remove **Origin addresses**.

 ![](https://support.taxcloud.com/api/attachments.redirect?id=9c9f0375-6269-406e-af9f-5f50ba5f18ad " =826x330")

# Step 6: Test the integration

You should perform several test transactions to ensure that everything is working properly.


1. Add some items to your cart and go through the checkout process to make sure sales tax is calculated and applied (in Real Time mode) or that taxes match your WooCommerce/third-party configuration (in Data Import mode).
2. After checking out, go to the **WooCommerce > Orders** page to mark your test order as “completed.”
3. Review your transactions by logging in to TaxCloud and navigating to the [Transactions](https://app.taxcloud.com/go/transactions) page.

# Step 7: Set the integration live

After you’re done testing, you can set the connection live in TaxCloud. After this point, all captured transactions are included in reporting and tax remittance.


1. In TaxCloud, go to the **[Integrations](https://app.taxcloud.com/go/integrations)** page.
2. Click the WooCommerce connection.
3. In the top-right corner of the page, click **Go Live**.

    ![](https://support.taxcloud.com/api/attachments.redirect?id=d1bd6d26-da27-4bba-963d-e67096fddda2 " =826x394")
4. Confirm that you want to go live.

That’s it – TaxCloud is set up to handle your tax calculations and/or order data capture for your WooCommerce store, depending on the integration mode you’ve selected.