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: 30/06/2018

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. Default Currency: The default currency will appear on your site if no auto-select option is enabled.
  6. 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.
  7. Currency: Select currencies here
  8. 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.
  9. 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.
  10. Number of decimals: Select how many numbers will be displayed after the command in each currency.
  11. Custom symbol: This option allows you to enter a custom symbol for each currency. Example America Dollar can be displayed as $, USD, $ US…
  12. Action: Allow you to update the exchange rate of a currency or remove that currency
  13. Update All Rates: Update exchange rates of all your currencies.
  14. Add Currency: This button will duplicate your last currency, then you back to option 6-Currency to select a new currency.


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 country of customers. The plugin will detect customers country base on their IP Address. Then select 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.
    – WPML: Similar to Polylang but base on WPML language.
  2. Geo API: The Geo API you want to use to detect customers’ country.  There are 2 options WooCommerce and External.
  3. Currency by Country: Work with Auto Detect turned on.
  4. Select which currency will be displayed for customers from which countries.
  5. Select all countries left.
  6. Remove all countries.


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. Select which currency is available for checkout.
  5. Payment methods: Select which payment methods will be available on the checkout page for each currency.


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 or Yahoo.
  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.

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.