Version 1.0.0 · Updated April 2026
Before installing Smart MultiCurrency, ensure your server meets the following minimum requirements:
✓ Smart MultiCurrency is tested with the latest versions of WooCommerce and WordPress and is HPOS (High Performance Order Storage) compatible.
smart-multicurrency.zip file, and click Install Now.smart-multicurrency.zip file on your computer.smart-multicurrency folder to /wp-content/plugins/.After activating the plugin, you'll see a notice at the top of the screen asking you to activate your licence.
Your licence key was emailed to you at time of purchase. You can also find it in My Account → Orders.
Navigate to WooCommerce → Smart MultiCurrency → Currencies to manage your currencies.
Repeat for each currency you want to offer. There is no limit to the number of currencies you can add.
For each currency, you can choose between two rate methods:
Enter a fixed exchange rate. For example, if your base currency is USD and you want to add GBP, enter 0.79 to set 1 USD = 0.79 GBP. This rate stays fixed until you update it manually.
Enable auto-update to pull live exchange rates daily from an external API. The rate is updated automatically in the background without any manual action.
⚠️ Automatic rates depend on external API availability. We recommend setting a fallback manual rate in case the API is temporarily unavailable.
When enabled, Smart MultiCurrency detects the customer's country from their IP address and automatically activates the matching currency on page load.
To configure: go to Smart MultiCurrency → Settings → Detection and enable Auto-detect customer currency. Then map each country to a currency in the Country → Currency mapping table.
You can also set a Default Currency that loads for any country not in your mapping (or if detection fails).
Smart rounding ensures converted prices look intentional rather than showing awkward decimals. Configure per currency in Currencies → [Currency Name] → Rounding.
Add a currency switcher to any widget area using the Smart MultiCurrency Switcher widget, or embed it anywhere using the shortcode:
[ca_currency_switcher style="dropdown"]
Available styles: dropdown, flags, text.
You can also add it to your header or footer by going to Appearance → Widgets and dragging the Smart MultiCurrency Switcher widget to your chosen area.
By default, Smart MultiCurrency locks the currency at checkout to match the customer's selected currency. This prevents currency changes after items are added to cart.
To configure: go to Smart MultiCurrency → Settings → Checkout.
Smart MultiCurrency is compatible with WooCommerce Subscriptions. When a subscription is created, the exchange rate at time of the first payment is recorded. Renewal charges use the customer's original currency at the original rate.
If you use dynamic exchange rates, we recommend reviewing your subscription renewal settings to ensure customers are not surprised by rate changes on renewals.
[ca_currency_switcher] — Currency switcher (default: dropdown) [ca_currency_switcher style="flags"] — Flag-based switcher [ca_price amount="99" from="USD"] — Display converted price inline
Check that Auto-detect customer currency is enabled in Settings → Detection. Also verify that your country-to-currency mappings include the customer's country. Clear your site cache after making changes.
WooCommerce caches product prices. Go to WooCommerce → Status → Tools and click Clear Transients to force a refresh. Also clear your caching plugin's cache.
Ensure at least one non-base currency is enabled. The switcher only appears when there are multiple currencies to choose from.
Ensure "Lock currency at checkout" is enabled. If the issue persists, check for conflicts with other currency or checkout plugins and contact support.
Our support team responds within 24 hours on business days. Include your site URL and a description of the issue for the fastest response.
Contact Support