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.

Check the Compatibility and Integration page before purchasing.

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 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}})" flag=1]

  • flag=1 adds flag icons to the drop-down list. Note: you may need to add CSS rules to match the selector with flags to your WordPress theme.

Below you can see the formatting examples:

WooCommerce Multi-currency - shortcode

Currency Selector in a Menu ↑ Back to top

If you cannot use our Widget, you can add the currency switching URLs to the menu:

WooCommerce multi-currency menu switcher
Please remember to update the menu items when you add or remove currencies.

Initial Currency Selection and Geolocation ↑ Back to top

If the “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.

Please read the document on how to configure the Geolocation:

MaxMind Geolocation Integration

Advanced Settings ↑ Back to top

Your WooCommerce Store is ready for multi-currency functionality. To learn how you can fine-tune it, check out the “Advanced Settings” instructions:

Multi-currency: Advanced Settings

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

Back to the top