> ## Knowledge Base Index > Fetch the complete knowledge base index at: https://help.tunl.to/sitemap.xml > Use this file to discover available pages before exploring further. > Pure-Markdown content can be obtained by appending a '.md' suffix to the content URLs listed in the sitemap (without the trailing slash). # 🚀 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. || ✨ New in live rates: free shipping, discounts and fees, duties by country and more. See [What's new in TUNL live rates](https://help.tunl.to/en/article/whats-new-in-tunl-live-rates-mbh8m6/). --- ### ✅ 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. ${frame}[WooCommerce Live Rates](https://www.loom.com/embed/4a44c92ded3642e3bd4335c6c746cdae?sid=60778048-d575-4753-9f32-ce1a40131841) --- ## 🛠️ **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. ||| ⚠️ Important: without HS codes and shipping details, rates and duties will not display. Your WooCommerce store should be configured with kg for weight and cm for dimensions. || You can also set fallback values for products that are missing data. In TUNL, go to Settings → Integrations → Store Integration, choose your store, then Checkout fallbacks and insurance. A fallback weight is required. Without a fallback HS code, products that are missing their own get a duties-on-delivery rate. | 💡 Tip: For bulk editing, use WooCommerce’s built-in Product CSV Import/Export feature to quickly add or update hs_code and country_of_origin attributes for many products. Learn more here → [WooCommerce Product CSV Importer and Exporter Guide](https://woocommerce.com/document/product-csv-importer-exporter/) ### 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](https://help.tunl.to/en/article/how-to-customise-your-shipping-options-at-checkout-1xskq4g/) . --- ### 🎉 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. | 💡 Your data is safe: Existing merchant configuration and stored API tokens will remain available after installing the new plugin. You should not need to reconnect or reconfigure your account after migrating. ### 🔧 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 or on [WhatsApp](http://wa.link/gpiyz3). ### 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** ![](https://storage.crisp.chat/users/helpdesk/website/-/e/a/5/b/ea5b318969f4c800/screenshot-2025-09-08-at-11223_1v11unx.png =866xauto) ###### Below is what it should look like when you're done: ![](https://storage.crisp.chat/users/helpdesk/website/-/e/a/5/b/ea5b318969f4c800/screenshot-2025-12-04-at-12504_1xkwxt8.png =924xauto) --- 👉 Ready to go? Log in to TUNL and connect your WooCommerce store today.