Multi-Currency for WooCommerce

Multi-Currency is a WooCommerce extension that provides switching currencies and re-calculating rates on the fly. Unlike the Currency Converter Widget, it uses the converted prices during checkout, so customers pay in the currency of their choice!

Important: We have tested Multi-Currency with many WordPress themes, plugins and third-party WooCommerce extensions, but some may still have compatibility issues.

Go to the Compatibility and Integration section below. Should you notice any problem, please read this page first, then contact us with the details and screenshots. We’ll do our best to find the solution!

Installation ↑ Back to top

  1. Download the extension from your WooCommerce dashboard.
  2. Go to Plugins > Add New > Upload and select the ZIP file you just downloaded.
  3. Click Install Now, and then Activate.

After activating the extension, the Multi-currency tab appears in WooCommerce Settings:Multi-currency settings tab

Setup and Configuration ↑ Back to top

Go to the Multi-currency tab to see the Settings Panel.

Currency Exchange Rates ↑ Back to top

The first step is to set up the Exchange Rates Service providers:Multi-currency - set up providers

WooCommerce Multi-Currency is capable of getting the rates from two providers: Currencylayer and OpenExchangeRates. Both have a free plan that is sufficient to have the rates updated every 12 hours.

To continue with the setup, you need to create an account and get your free credentials:

We recommend you to have both accounts, for better reliability.

Choose the provider, fill in the “Credentials” field and press “Save”. The currency rates will be retrieved and temporarily stored in the WordPress database. You will see the date and time when the provider has updated the rates:Multi-currency - timestamp

Setup Currencies ↑ Back to top

Next, choose the currencies you want to use on your website. Don’t forget to add the main currency, too:
Multi-currency - select

Important: make sure that your payment gateway (PayPal, Stripe, etc.) is configured to accept payments in all those currencies! If a gateway does not support some currencies, you can use the Conditional Shipping and Payments extension to restrict the gateway to specific currencies.

The Currency Selector Widget ↑ Back to top

Multi-currency widget

This Widget could be placed in any sidebar or in the footer. A good place would be right above the shopping cart widget.

The title is what will be displayed above the drop-down.

The drop-down content is controlled by the “Display format” setting. You can show the currency code (USD, CAD, EUR, etc.), the name (“United States Dollar”, “Canadian Dollar”, “Euro”) and the symbol (“$”, “€”) – in any combination. For example, if you enter only {{code}}, your visitors will see only USD, CAD, EUR in the drop-down.

The Currency Selector shortcode ↑ Back to top

To embed the Currency Selector in a page or post, you can use the shortcode with the same format settings as with the Widget:

[woocommerce-currency-selector format="{{code}}: {{name}} ({{symbol}})"]

Below you can see the formatting examples:

WooCommerce Multi-currency - shortcode

Initial Currency Selection and Geolocation ↑ Back to top

Starting from the Version 1.4.0, if “Default Customer Location” is set to “Geolocate” in WooCommerce->Settings->General, we will detect the site visitor’s currency by their country.

If your Store accepts that currency, it will be automatically selected. Otherwise, the Store’s default currency will be used.

Advanced Settings ↑ Back to top

Your WooCommerce Store is ready for multi-currency functionality. To learn how you can fine-tune it, check out this page.

Compatibility and Integration ↑ Back to top

WooCommerce Multi-currency is tested with:

  • Standard product types: Simple and Variable
  • Subscriptions
  • All Products For Subscriptions (formerly “WooCommerce Subscribe All The Things”)
  • Bookings and Accommodation Booking
  • Product Add-Ons and Checkout Add-Ons
  • Dynamic Pricing
  • Dynamic Pricing Table
  • Name Your Price
  • Conditional Shipping and Payments
  • Product Vendors

Not compatible with:

  • WooCommerce Deposits extension.

Shipping Methods ↑ Back to top

We have tested the Flat Rate, Free Shipping, UPS, USPS, FedEx, Canada Post, Australia Post, Royal Mail, and Table Rate shipping methods.

Not supported:

  • Purolator

If your site is using a shipping method not listed above, please contact Support to verify the compatibility before purchasing the Multi-currency extension.

Reports ↑ Back to top

The Sales Reports show totals only for one currency at a time.

Caching Plugins ↑ Back to top

The page-caching plugins save static HTML version of the site pages. Those pages will stay unchanged until the cache is expired or deleted. Therefore, they will always show the same prices, promotions, inventory – and currency.
To avoid that, you should exclude the shop and product pages from being cached. Consult the plugin documentation for the instructions on how to do it.

WP Super Cache plugin support

The WP Super Cache plugin version 1.6.3+ is supported. If you have an earlier version, please upgrade.

WP Engine hosting cache

If you host your site with WP Engine, please contact their technical support and let them know that your site is using the WooCommerce Multi-currency extension and that their caching system should take the woocommerce_multicurrency_forced_currency cookie into account.

WP Fastest Cache, W3 Total Cache, WP Rocket, and other caching plugins

These plugins are not supported. Please let their authors know that you are interested in the integration of their caching plugins with WooCommerce-Multicurrency.

WooCommerce - the most customizable eCommerce platform for building your online business.

Back to the top