WooCommerce Ultimate Multi Currency Suite documentation#

WooCommerce Ultimate Multi Currency Suite is available exclusively on CodeCanyon.

Basic information#

If you are reading this, it means that you probably already know what this plugin is supposed to do. But just to make sure - WooCommerce Ultimate Multi Currency Suite is a WordPress-WooCommerce extension plugin that allows your webstore visitors to see your product prices in various currencies.

Depending on plugin configuration, prices in each currency can be configured manually or automatically converted from the base currency. Conversion can happen only for user's reference (while the payment is still happening in your store's base currency) or for the whole transaction (you will receive payment in alternative currency).

Plugin offers many features which make it the most complete multi-currency solution for any ecommerce system on the market.

Now that we know what we are dealing with here, let's see how to get this beast up and running!

Quick start#


  • Standard WordPress method

Download plugin from your CodeCanyon account ("Installable WordPress file only") and upload this zip file using Plugins > Add new > Upload Plugin uploader in your WordPress Admin dashboard. After plugin is successfully installed, go to Plugins section in WordPress Admin dashboard, find WooCommerce Ultimate Multi Currency Suite on the list and click Activate next to it.

  • FTP method

Upload the woocommerce-ultimate-multi-currency-suite folder to wp-content/plugins on your server. Go to Plugins section in WordPress Admin dashboard, find WooCommerce Ultimate Multi Currency Suite on the list and click Activate next to it.

Plugin activation#

In order to be able to receive automatic updates with new plugin features and security fixes, you also need to activate the plugin using your Envato Purchase Code. To do so, please go to WooCommerce > Settings > Multi Currency Suite > Plugin activation in your WordPress Admin Dashboard. In Your purchase code field please paste your Envato Purchase Code, which you can find in Downloads section of your Envato account and in the e-mail you received right after purchasing this item. After clicking Save changes, your plugin will be activated.

Can't find your Purchase Code? Here is an article on Envato explaining where to find it - Where Can I Find my Purchase Code?

Plugin setup#

By default plugin is configured to set currency based on visitor's location. To allow these alternative currencies to be used, you need to make them available in plugin settings. To do so, go to Currencies section in settings and by using Add currency button, add alternative currencies.

That's it! Your WooCommerce Ultimate Multi Currency Suite is ready to go!

Please explore plugin settings to adjust the plugin to your needs. In this documentation you can find detailed description of all plugin features.


Although the plugin was written with quality in mind, sometimes the unexpected can happen.

In the very unlikely event of experiencing any problems with the plugin, the first thing you need to do is to check your software versions.

WooCommerce Ultimate Multi Currency Suite has the following requirements:

  • PHP: 5.6 minimum
  • WordPress: 5.0.3 minimum
  • WooCommerce: 3.5.3 minimum

Please keep in mind that WooCommerce must by activated for this plugin to work.

While WordPress and WooCommerce are relatively easy to update, you may not be used to updating your PHP. However, it is very important to keep your PHP version up to date. PHP 5.3.x and 5.4.x are still very popular even though they have been discontinued for a very long time. PHP 5.3 and 5.4 is a very old software now and if you have it on your server, you need to update it to at least PHP 5.6.x. New PHP versions are more secure, more reliable and significantly faster than the old ones.

Updating PHP#

PHP can usually be updated in your server panel - cPanel and DirectAdmin are the most popular ones. If you don't know how to do it, just contact your hosting provider and they will do it for you within minutes - tell them you need at least 5.6.x version of PHP.

Still experiencing problems?#

If updating your environment didn't help, please go to plugin Settings > Advanced tab and click Restore default settings. This will remove all plugin settings and restore them to default ones.

If you still have problems with the plugin, please contact me! I provide support through CodeCanyon messages. Please contact me using the Envato account that was used to purchase the plugin. Contact me using the contact form on the right - https://codecanyon.net/user/dev49net


Version 1.12.1 (2019.01.21)

  • WordPress 5.0.x and WooCommerce 3.5.x full compatibility
  • Updated exchange rates APIs
  • DEV: Make frontend and admin classes public properties of Main plugin class
  • DEV: Remove wc_version from frontend variables

Version 1.12.0 (2018.06.06)

  • Added WooCommerce 3.4.x compatibility
  • Added Docs entry on the Plugins list
  • Fixed issue with occasional currency switch betweeen backend and frontend
  • Fixed issue with order preview in admin dashboard taking currency from the frontend
  • Fixed occasional issue with invalidating variations prices cache
  • Removed Google Finance API, as it no logner works
  • Removed WooCommerce 3.1/3.2 support entirely
  • DEV: Added wcumcs_custom_reference_price_final filter

Version 1.11.0 (2018.03.22)

  • Added WooCommerce 3.3.x compatibility
  • Fixed occasional issue where item was displayed as being on sale, even though it wasn't
  • Improved exchange rates update reliability
  • Fixed issue with invalidating cached variation prices, causing the plugin to perform multiple unnecessary database updates
  • Fixed issue with minimum order amount for free delivery coupon

Version 1.10.0 (2017.11.12)

  • Added WooCommerce 3.2.x compatibility
  • Fixed issues with exchange rates updates (added new APIs, removed not working ones)
  • Removed WooCommerce 2.6 compatbility - only 3.x is supported from now on
  • Multi-currency free shipping minimum order amounts support
  • Minor fixes and improvements
  • DEV: Add filter for final custom product price

Version 1.9.1 (2017.06.01)

  • Fixed crossed price issue on certain WooCommerce setups
  • Fixed called to undefined function error when activating without WooCommerce activated
  • Fixed modal window when specifying geolocation country-currency relation
  • Fixed storing base currency price values when creating order from backend
  • Allow to convert prices when creating order from backend in new currency
  • Check if GeoIP database exists when activating Geolocation
  • Minor compatibility fix for PDF Invoices plugin
  • Add minimum and maximum order amounts in each currency for coupons
  • DEV: Add filter to specify max number of currencies

Version 1.9 (2017.04.19)

  • WooCommerce 3.0.x compatbility
  • Fixed error in price conversions when creating order from the backend
  • Improved mechanism checking if WooCommerce is active

Version 1.8 (2017.01.17)

  • WordPress 4.7.x ready
  • Added support for WooCommerce Reports
  • Fixed potential JavaScript errors
  • Improved WooCommerce activation checking
  • Improved price slider compatibility
  • Improved geolocation mechanism
  • Improved wcumcs_convert shortcode
  • Fixed fees converting
  • Fixed automatic exchanges rates updates occasional failure
  • Fixed price formatting in certain cases
  • Completely dropped WooCommerce 2.5 compatibility
  • Fixed storing alternative currency prices for simple products when using comma as decimal separator
  • Fixed multi-currency prices display in product edit page (variable products only)
  • DEV: Added wcumcs_currency_switcher_output_html filter
  • DEV: Deprecated wcumcs_currency_switcher_html filter

Version 1.7 (2016.07.13)

  • Full WooCommerce 2.6.x compatibility
  • Shipping taxation fix
  • JavaScript syntax fixes
  • Alternative currencies custom orders fix
  • New wcumcs_{currency_code}_exchange_rate_update_value filter
  • WooCommerce Composite Products Widget issue fix
  • Only one plugin instance allowed
  • Fixed displayed price taxation issue on variable products
  • Fixed currency symbol issue on orders placed in alternative currencies
  • Added [wcumcs_convert] shortocde
  • Ability to add switchers via filters - wcumcs_currency_switcher_themes and wcumcs_currency_switcher_theme_{name}
  • Added feature to configure payment gateways for each currency
  • Fixed currency switching issue on AJAX-loaded content
  • Fixed conversion problem on very specific use case
  • Added startup currency feature
  • Added feature to change currency via GET parameter
  • Fixed price filter issues
  • Dropped WooCommerce 2.4.x support
  • Fixed possible currency conflicts with the new WooCommerce REST API
  • Minimum required WordPress changed to 4.5
  • Fixed free shipping minimum required amount conversion
  • Predefined shipping cost fix
  • Set multi-currency prices across all variations
  • Fixed possible error with custom prices when comma was used

Version 1.6.1 (2016.02.06)

  • Fixed WooCommerce Composite Products compatibility problem
  • Fixed currency conversion when placing order in reference conversion mode with cheque payment method
  • Improved restore default settings functionality
  • Couple of minor fixes

Version 1.6 (2016.01.24)

  • Full WooCommerce 2.5 compatibility
  • Added Mangohour Table Rate Shipping compatibility
  • Added option to change order currency on order edit page
  • Added option to specify shipping cost in multiple currencies
  • Improved automatic exchange rates update mechanism
  • Many fixes and improvements

Version 1.5 (2015.11.28)

  • Added compatibility with page caching plugins
  • Currency switcher text (and all other strings) can now be easily translated with WPML
  • Fixed possible WP-Admin error with WooCommerce disabled
  • Fixed price calculation for grouped products
  • Fixed possible minor problems with certain payment gateways
  • Fixed plugin settings UI in Firefox
  • Fixed possible currency conflict when creating custom order in WooCommerce admin dashboard
  • Improved currency exchange rate autoupdate mechanism
  • 3 new currency exchange rates APIs (6 now in total)
  • Improved security of admin AJAX requests
  • WordPress 4.4 ready

Version 1.4 (2015.08.29)

  • Fixed possible PHP error on AJAX calls

Version 1.3 (2015.08.16)

  • WordPress 4.3.x and WooCommerce 2.4.x ready
  • Improved AJAX cart behaviour after switching currency
  • Fixed possible error when auto-updating exchange rates
  • Improved translations
  • Improved uninstallation process and Restore default settings feature
  • Switched from using cURL to WordPress HTTP API to maintain compatibility with hosting providers
  • Fixed exchange rates formatting - no more trailing decimal zeros in the exchange rates table
  • Fixed possible error in confirmation email after PayPal payment
  • Added new filter for supplying alternative country code when using geolocation (only for developers)

Version 1.2 (2015.08.03)

  • Base prices for Composite Products plugin are now converted to alternative currencies
  • Added support for price filter widget
  • Added support for "free shipping for orders over..." rule
  • Added support for minimum and maximum order amount for coupons

Version 1.1 (2015.07.23)

  • Fixed AJAX cart update issue on some themes
  • Improved performance on some servers by using transient cookies instead of sessions
  • Increased number of currencies limit
  • Improved plugin settings

Version 1.0 (2015.07)

  • Initial release