WooCommerce Multi Currency

Thank you for using our plugin. If you have any questions that are beyond the scope of this documentation, please feel free to request support at our Support Forum. Thanks so much!

Created: 11/06/2017
Latest update: 22/05/2020

Updated to WooCommerce Multi Currency ver

By: Villatheme

Do you want to display price as multi currencies on your shop page? Do you want your site to autodetect customer’s country and display price as their native currency? Do you want to accept payment in customer’s native currency? Woo Multi Currency will help you with all these things.

System Requires

It is recommended using

1. Plugin WooCommerce 3.2 or newer is installed and activated.

2. Make sure that those limits to a minimum as follows in order for free-trouble while installing.

max_execution_time 60
memory_limit 256M
post_max_size 64M
upload_max_filesize 64M

Download Plugin

Get the plugin installation package from your account download page and save it to your desktop.

Install & Active plugin

Go to PluginsAdd NewUpload PluginChoose file/ Select  woo-multi-currency.zip file/ click “Install Now“/ click “Active plugin“.

Install and Set up Video

Done! Let’s start using the plugin.

After installing the plugin, please go to Dashboard/ Multi Currency/ General to set up your currencies and exchange rates. Then there should be a currencies bar appear on your site, allowing customers to switch between currencies.



In General, you can set up the main features of WooCommerce Multi Currency

  1. Enable: Enable/Disable the plugin
  2. Fixed Price: The plugin allows you to enter custom prices in different currencies for each product. This custom price will overwrite the price calculated by the exchange rate. You can enter fixed prices in product edit pages.
  3. Use SESSION: By default, the selected currency will be saved in cookies. Turn on this option will let the plugin save this information in session instead of cookies. This option is useful for websites with cache, where the selected currency change back to the default currency after reloads.
  4. Currency Price Switcher: Display a price switcher under product price on product pages, allow customers to switch the price between currency. There are 4 options for you to select
    No – disable this option.
    Flag – display
  5. Switch Currency by JS: Enable it to make currency will be changed but it does not use URL. It is good for SEO. Now it is not compatible with Caching plugin
  6. Default Currency: The default currency will appear on your site if no auto-select option is enabled.
  7. Hidden: This option allows you to hide some currencies which you don’t want to appear on front-end. By selecting Yes, you will hide that currency on front-end.
  8. Currency: Select currencies here
  9. Position: Select how will prices be displayed on the front-end. The price before the symbol, the symbol before the price, with or without space.
  10. Rate and exchange fee: Rate can be entered by yourself or the plugin will automatically fill in. The exchange fee can be changed by you only.
  11. Number of decimals: Select how many numbers will be displayed after the command in each currency.
  12. Custom symbol: This option allows you to enter a custom symbol for each currency. Example America Dollar can be displayed as $, USD, $ US…
  13. Action: Allow you to update the exchange rate of a specific currency or remove that currency
  14. Update All Rates: Update exchange rates of all your currencies.
  15. Add Currency: This button will duplicate your last currency, then you back to option 8-Currency to select a new currency.
  16. Add All Currencies: Add all currencies on your settings.
  17. Remove All Currencies: Remove all existing currencies.


In Location tab, you can set up the plugin to automatically select currency base on customers’ country or language.

1. Auto Detect: There are 4 option for you to select
– No: Turn off the auto detect currency option, customers will select currency by themselves
– Auto select: Auto detect currency base on the country of customers. The plugin will detect customers’ countries base on their IP Address. Then select the currency which you assign in option 4 of this tab.
– Approximate Price: The plugin will detect customers’ country then display an approximate price in their native country under WooCommerce price
– Polylang: Auto select currency base on Polylang language.

2. Geo API: The Geo API you want to use to detect customers’ countries.  There are 2 options WooCommerce and External.

3. Currency by Country: Work with Auto Detect turned on. Currencies will be displayed base on customers ‘s countries.

4. Countries: Select which currency will be displayed for customers from which countries.

5. Select all: Select all countries for displaying a specific currency.

6. Remove all: Remove all existing countries.

7. Get country by currency: Automatically enter the countries that use the corresponding currencies.


In Checkout tab, you can select which currencies will be able to check out. And which payment methods are able to check out with each currency.

  1. Enable/Disable: the option to change currency to available checkout currency in the checkout page.
  2. Enable Cart Page: Change currency in the Cart page to check out currency.
  3. Default currency: The default currency on the checkout page. When the selected currency is not available for checkout. The currency on the checkout page will be forced to the default checkout currency.
  4. Checkout Curency: Select which currency is available for checkout.
  5. Payment methods: Select which payment methods will be available on the checkout page for each currency.
  6. Currency by Payment method: Use this option if you want to put a mandatory currency with the respective pament gateway after clicking on the “Place order”
  7. Change currency follow: the currency on checkout pagre can choose to change follow to : Shipping address, Billing address or None.
  8. Display multi currencies: Enable to display both in store pages and checkout page if they are different at the check out page.


Design tab, where you can configure the front-end interface of the plugin.

  1. Enable/Disable the currencies bar. The bar float on a sidebar of your site, allows customers to switch currencies.
  2. Enter the title of the currencies bar.
  3. Select currencies bar position.
  4. Currencies Bar Collapse: this option allows you to minimize the currencies bar on desktop. The currencies bar will appear as 1 selected currency and will display full when customers hover their mouse on it.
  5. Select the color of currency bar text.
  6. Select the style of the currencies bar, there are 4 options for you to select: Default (Currency code), Symbol, Flag,  Flag & Currency Code, Flag & Currency symbol.
  7. Configure the color of the currencies bar.
  8. Enable to hide currencies bar on the checkout page.
  9. Enable to hide currencies bar on the cart page.
  10. Configure where will the currencies bar appear by using WP conditionals Tags.
  11. Flag Custom: The option for you to replace a flag with your own flag.
  12. Custom CSS: Allow you to add your own CSS code to design the currencies bar or widget.


In Update, you can find options about the auto-update currency exchange rate and the plugin.

  1. Auto update exchange rate: Select the time when the plugin will update exchange rates. Every 30 minutes, 1 hour…
  2. Finance API: Select where exchange rate will be got. From Google, Yahoo, Transferwise and Cuex.
  3. Rate decimals: Select the exchange rate decimals
  4. Emails: Enable this option to receive an email whenever exchange rates are updated successfully.
  5. Email Custom: When you don’t want to receive updated exchange rate email in admin email.
  6. Purchase Code: Fill in your Envato purchase code to auto-update the plugin feature.

Price Format

This setting allows you to make your price more beautiful, you will set the rules to create your desired product price.

price format

  • Enable: To activate the option.
  • Accept lower bound: Enable if you accept making price beautiful for both lower bound and upper bound price. Disable this function will be applied for upper bound price only.


* Note: This feature is not applied for shipping. 




The plugin provides you shortcodes to display currencies exchange widgets, exchange rates on the front-end.

  • Currency Selector widgets with different front-end styles.
Shortcode Description
  • Exchange rate shortcodes allow you to display live exchange rates on the front-end.
    [woo_multi_currency_rates currencies=”GBP,EUR”] This shortcodes will display the exchange rate between GBP, EUR and your default currency on front-end. You can change to other currencies by change the currencies codes GBP, EUR
    [woo_multi_currency_exchange price=”100″ currency=”EUR”] Example I have USD as my default currency, this shortcode will display the EUR amount converted from 100 USD.




Plugin Author Converted Price Fixed Price
WooCommerce Product Bundles SomewhereWarm Yes No
WooCommerce PDF Invoices & Packing Slips Ewout Fernhout Yes No
WooCommerce Bookings WooCommerce Yes No
Printful Integration for WooCommerce plugin Printful Yes No
Table Shipping Rate WooCommerce Yes No
WooCommerce Wholesale prices Rymera Web Co Yes No
LearnPress ThimPress Yes No
WooCommerce Dynamic Pricing & Discounts plugin RightPress Yes No


Plugin Author Compatible
Polylang Frédéric Demarle Change currencies base on language
WPML OnTheGoSystems Change currencies base on language
Autoptimize Frank Goossens (futtta) Require to change WooCommerce settings
WP Fastest Cache Emre Vona Require to change WooCommerce settings
WP Super Cache Automattic Require a free plugin
WP Rocket WP Media Fully compatible
W3 Total Cache Frederick Townes Fully compatible
WooCommerce Extra Product Options themecomplete Fully compatible
Event Tickets Modern Tribe, Inc. Fully compatible
The Events Calendar Modern Tribe, Inc. Fully compatible
Name Your Price Kathy Darling Fully compatible

Extra Information

Thank you for your attention!

If you have any question, please create a topic at our FORUM, we will support within 24 hours.