Follow these steps in order to diagnose and fix the most common issues with the Tax & Duty King widget.
In Shopify Admin, go to Online Store → Themes → Customize. Click the App Embeds icon (puzzle piece) in the left sidebar. Find Tax & Duty King and ensure the toggle is ON. Click Save. This is the most common cause of the widget not appearing.
Still in the Theme Editor, use the page selector at the top to navigate to Cart. In the left sidebar, click Add block. Scroll down to the Apps section and click Tax & Duty King. Drag the block to your preferred position (typically just above or below the cart totals). Click Save.
The widget only appears for international destinations. If you are testing from a UK store with a UK shipping address, the widget will not show. Change the shipping country in your cart to a supported international country (e.g. Germany, USA, France) to test. You can also use a VPN to simulate an international visitor.
Open your browser's developer console (F12 → Console tab) while on your cart page. Look for any red error messages. Common conflicts include:
If you see errors, contact our support team with a screenshot of the console errors and your theme name.
HS codes are the foundation of accurate duty calculations. Go to the HS Codes tab in the app. Check that your products have HS codes assigned (Status: Approved or Overridden). If products show "Pending" in the Shopify column, click Push All to Shopify to sync them.
The country of origin determines whether TCA zero-duty or other preferential rates apply. Check the Settings tab and ensure the correct country is set. If your products are manufactured in multiple countries, use the multi-origin feature to assign per-product origins.
VAT and duty rates change periodically. Go to the VAT Rates and Duty Rates tabs and click Run Now on the AI agents to fetch the latest rates. The agents run automatically every week, but you can trigger an immediate update at any time.
Import fees are displayed in the customer's local currency. If the converted amount looks unexpected, check the Currency Rates tab to verify the current exchange rates. The currency agent updates rates daily.