🚀 How to Set Up the TUNL WooCommerce Plugin

Welcome to the TUNL WooCommerce Plugin! 🎉

This guide will walk you through the steps to connect your WooCommerce store to TUNL so you can start showing live international shipping rates at checkout, with duties and taxes handled the way you choose.

✅ What You’ll Need Before You Start

• Access to your WooCommerce Admin Dashboard
• A TUNL account (sign in at app.tunl.to)
• Product weights, dimensions, and HS codes (for accurate duties & tax calculation)

🎥 Video Walkthrough

To make it even easier to understand how the WooCommerce Live Rates at Checkout feature works, we’ve created a quick video walkthrough.

🛠️ How to Get Started

Step 1: Install the Plugin

1. In your WordPress Admin, go to Plugins → Add New.
2. In the search bar, type TUNL Shipping for WooCommerce and press Enter.
3. Click Install Now, then Activate.

Step 2: Generate Your API Token

1. Go back to TUNL.
2. Enter your WordPress website URL e.g. https://www.mystore.com
3. Click Generate Token.
4. Click Approve.
5. Copy the token (click the copy icon — you’ll need it in the next step).

Step 3: Connect WooCommerce to TUNL

1. In WooCommerce Admin, go to Settings → TUNL Plugin.
2. Paste your API token into the field provided.
3. Click Save API Token.

Step 4: Prepare Your Products

For rates to display correctly, each product needs:

• HS Code:

1. Edit a product in WooCommerce.
2. Go to the Attributes section → add attribute called hs_code.
3. Enter the correct HS code and save.

• Country of Origin:

1. Edit a product in WooCommerce.
2. Go to the Attributes section → add attribute called country_of_origin.
3. Enter the correct 2-letter country code (e.g. ZA) and save.

• Weight & Dimensions:

1. While editing a product, go to the Shipping tab.
2. Enter Weight (kg) and Dimensions (L × W × H in cm).
3. Save.

Learn more here → WooCommerce Product CSV Importer and Exporter Guide

Step 5: Enable TUNL Shipping Method

1. In WooCommerce, go to Settings → Shipping → Shipping Zones.
2. Edit your international zone (e.g., Rest of the World).
3. Click Add Shipping Method → Choose TUNL Shipping.
4. Save.

Step 6: Set up your rates and publish

1. In TUNL, go to Settings → Integrations → Store Integration and choose your WooCommerce store.
2. Work through Services, Duties & taxes and Checkout fallbacks and insurance. Add discounts and handling fees if you want them.
3. If your store lets customers pay in more than one currency, turn on Multi Currency at Checkout on the fallbacks page.
4. Check the preview, then click Publish to store.

Nothing reaches your checkout until you publish. For every setting in detail, see How to customise your shipping options at checkout .

🎉 You’re Live!

That’s it! TUNL-powered live rates are now available in your WooCommerce checkout.

• Customers see your international shipping options, with duties and taxes shown the way you've chosen.
• You’ll save time and protect your margins with accurate, automated rates.

Migrating from the Old Plugin

If you already have the TUNL WooCommerce plugin installed, follow these steps to migrate to the new TUNL Shipping for WooCommerce plugin:

1. Log in to your WordPress Admin Dashboard.
2. Navigate to Plugins → Installed Plugins.
3. Locate TUNL Woo.
4. Click Deactivate, then click Delete to remove the old plugin.
5. In your WordPress Admin, go to Plugins → Add New.
6. In the search bar, type TUNL Shipping for WooCommerce and press Enter.
7. Click Install Now, then Activate.

🔧 Troubleshooting

• Rates not showing? Double-check that products have HS codes + weight/dimensions.
• Make sure you're on TUNL Shipping for WooCommerce, not the older TUNL Woo plugin. See Migrating from the Old Plugin above.
• Changed a setting but nothing's different at checkout? Make sure you clicked Publish to store.
• Duties missing at checkout? Check the product has an hs_code attribute, or that you've set a fallback HS code.
• Check your WooCommerce store is properly configured with kg for weight and cm for dimensions.
• Still stuck? Contact us by email at support@tunl.to or on WhatsApp.

We're compatible with Bobgo! If you're having issues with getting rates, please do the following:

1. Make sure “Don’t return other services rates” is unchecked

• In your WooCommerce store, Bobgo has a setting that prevents other shipping services from returning rates.
• This must be unchecked, otherwise TUNL rates may be blocked.

Where to find it:
WooCommerce → Settings → Shipping → Bobgo → Integration settings

2. Add an International Zone in Bobgo (and keep it empty)

• If you’re not able to configure Bobgo rates for international destinations, add an International shipping zone inside Bobgo and set it to No rates.
• This prevents Bobgo from overriding or interfering with TUNL’s international rates.

Where to find it:
Bobgo Dashboard → Rates at Checkout → Add Rate / Add Zone → Select International

Below is what it should look like when you're done:

👉 Ready to go? Log in to TUNL and connect your WooCommerce store today.

Updated on: 30/10/2026