CURCY Multi Currency for WooCommerce

Created: 2026.06

Latest updated: 2026.06 – Updated version: 1.0.0

By: VillaTheme

Thank you for purchasing 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!

**IMPORTANCE NOTICE**

We have tested CURCY Multi Currency for WooCommerce with many WordPress themes, plugins, and 3rd party WooCommerce extensions, but it’s impossible to test them all, so some may still have compatibility issues. Please read the Compatibility documentation section. Should you notice any problem, please contact us with the details and screenshots. We’ll do our best to find the solution!

 

FILE INCLUDES

Instruction

CURCY – Multi Currency for WooCommerce is a currency converter plugin for WooCommerce, which allows you to display prices and accept payments in multiple currencies. The plugin can detect customers’ countries and languages, and apply prices in their native currency. It is also convenient for users to switch between different currencies using a currencies bar to find their preferred currency among the available options.

Important Update: The plugin settings have been integrated directly into WooCommerce > Settings (instead of a separate menu item) for a more seamless and unified management experience.

THE PLUGIN FEATURES

CURRENCY OPTIONS

The plugin is flexible with many currency options for front-end display and exchange rate management:

  • Auto-update exchange rate: Automatically update exchange rates at set intervals: every 30 minutes, 1 hour, 6 hours, 1 day, 2 days, 3 days, 1 week, or 1 month.
  • Successful update exchange rate email: Receive a notification email whenever exchange rates are updated successfully.
  • Set the exchange rate manually: Manually set and override exchange rates according to your needs.
  • Exchange fee: Add permanent exchange fees to exchange rates to cover processing fees or bank exchange rate differences.
  • Price formatting: Customize the position and format of currency symbols.
  • Custom currency symbol: Customize currency symbols (e.g., United States Dollar can be displayed as USD, US$, $, etc.).
  • Fixed Price: Set custom fixed prices in different currencies for individual products, overriding calculated exchange rate prices.
  • Hidden Currency: Hide specific currencies from being displayed on the front-end.
  • Select currency exchange rate server: Fetch live exchange rates from VillaTheme.com, Google Finance, Yahoo Finance, TransferWise, Cuex, Xe, and more.
  • Data storage method: CURCY supports 4 storage methods — Cookie, Session, WooCommerce Session (beta), and Transient (beta) — ensuring optimal compatibility with different server and caching setups.
  • Currency Price Switcher: Displays a switcher directly under product prices, allowing customers to quick-switch prices between currencies.

AUTO-DETECT CURRENCY

WooCommerce Multi Currency can automatically detect customers’ native currency based on their country or language.

*Important: Please note that auto-detect country features may not work properly with websites/servers that use aggressive caching. Please try out the free version to test compatibility with your site.

  • Detect currency based on customers’ country: Automatically detects customer country via IP address and displays prices in their local currency (applies at country level, not state/province).
  • Currency by country: Assign specific currencies to be displayed to visitors from specific countries.
  • Approximate Price: Displays product prices in the site’s default currency while showing an approximate price in the customer’s native currency right below it.
  • Auto-select currency based on Polylang language: Automatically matches currencies to Polylang site languages (e.g., display GBP on English pages and EUR on Spanish pages).
  • Auto-select currency based on WPML language: Automatically matches currencies to WPML site languages.

CHECKOUT CURRENCY

CURCY allows you to configure specific currencies for the checkout process.

*Important: To display a payment gateway on the checkout page, that gateway must support your store’s default currency. (e.g., If your default currency is ZAR, PayPal cannot be enabled even if Multi-Currency converts ZAR to USD on the front-end, because PayPal does not natively support ZAR).

  • Allow multi-currency payment: Enables customers to complete purchases in their selected currency (requires payment gateways that support the selected currency).
  • Selected check-out currencies: Display prices in multiple currencies throughout the store while restricting final checkout payments to specific accepted currencies.
  • Display payment methods based on currency: Dynamically show or hide payment gateways on the checkout page based on the active currency.
  • Checkout Currency on Cart page: Automatically switches the currency on the Cart page to match the designated checkout currency.

PRICE FORMAT

Set rules to display clean and attractive “beauty prices” on the front-end:

  • Accept lower bound: Apply beauty price rules to both lower and upper bound prices (disabling applies rules to upper bound prices only).
  • Add rules: Set custom rules to format price numbers on the front-end (e.g., rounding to .99 or .00).

SHORTCODES & DESIGN

  • Shortcodes: Built-in shortcodes to display currency switcher widgets and exchange rate tables anywhere on your site.
  • Currencies bar design:
    • Customize currencies bar title (default: “Select your currency”).
    • Set bar position (left or right) and customize colors/backgrounds.
    • 5 visual styles: Currency code, Currency symbol, Flag, Flag + Currency code, Flag + Currency symbol.
    • Collapse mode: Minimizes the bar into a compact icon that expands on hover.
  • Conditional tags: Control which pages display the currencies bar using WordPress and WooCommerce conditional tags.
  • Custom Flag & CSS: Upload custom flags and add custom CSS to fully tailor the styling to your theme.

INSTALLATION

Required

1. WordPress 5.0+

2. PHP 7.0+

3. WooCommerce 7.0+

 

Download Plugin

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

Install & Active plugin

Go to Plugins/ Add New/ Upload Plugin/ Choose file/ Select  curcy-multi-currency.zip file/ click “Install Now“/ click “Active plugin“.

 

Install and Set up Video

Done! Let’s start using the plugin.

 

How to use

After installing the plugin, please go to WooCommerce / Settings / Multi Currency / General >> Enable the plugin to start using the plugin.

Make sure to click “Save” to save the settings.

Configure the currency list

After activating the plugin, start building a list of currencies in the General settings. This is an important part as the currency list is the basis, all other functions of the plugin will work based on this list.

This needs to be done in the “Currency Options” table at the end of the tab.

Step 1: Go to the WooCommerce / Settings / Multi Currency / General tab of the plugin settings

Step 2: In the “Currency Options” table, click “Add currency” to add more currencies you need.

Step 4: Configure each currency.

Step 5: Click “Save settings“.

Please regard this documentation – part (9) Currency option – for a specific explanation of each option.

How to set fixed price

Note:

  1. If the fixed price of some particular products/in some specific currencies is not added, it’ll show the price converted using the exchange rate when users switch currencies. So you still need to configure the exchange rate.
  2. The sale fixed price can only be configured in either all currencies, or no currency. If you configure the sale price of an item in one currency, you must configure the sale price in all other currencies, regardless of default or non-default currency.
  3. For the regular price, please note that our plugin does not display specific currency per product, so you must configure the regular price in the default currency.
  4. “Fixed price” is not applied to the WooCommerce Coupon value.

 

CURCY allows the admin to add a fixed price to the product price for each currency you have on your list. You can use this feature for:

  1. WooCommerce Products
  2. WooCommerce Shipping methods

First, enable the “Fixed Price” option in the plugin settings.

Now, there will be fields to add the price in different currencies in the product data. The fixed price of the product in each currency can be added, it will overwrite the price converted using the exchange rate when users switch currencies.

 

Products

1. To add fixed prices for particular products, follow these steps below:

  • Go to Dashboard > Products > Select a product
  • Scroll down to the Product data of that product
  • Add fixed prices according to necessity.

With the “Simple product” type

 

With the “Variable product” type:
Add the fixed price for all variations of the product as below:

 

Another way, you can add a fixed price in one currency for ALL variations of that product:

Go to Product data > Variations > In the “Add variation” option > Scroll down to see the option to set regular/sale prices in each currency of Multi Currency

 

2. To add fixed prices in bulk using a CSV file, visit this documentation for specific steps.

 

 

Shipping

“Fixed price” feature works for not only WooCommerce products, but also WooCommerce shipping methods: Flat rate and Free shipping.

 

1. Free Shipping

Once you enabled Fixed price and create “Free shipping” shipping method in WooCommerce Shipping settings, if you select any option among the 3 below in “Free Shipping Requires” dropdown:

  • A minimum order amount
  • A minimum order amount OR a coupon
  • A minimum order amount AND a coupon

>> You are able to adjust the fixed required amount for this shipping method in each currency.

 

 

2. Flat rate

Similar to Free Shipping, if you create and configure “Flat rate” shipping method in WooCommerce Shipping settings and use Fixed price feature of our plugin, then you can enter fixed flat rate in each currency like this:

 

 

Change order currency

After an order is placed, the admin can change the currency order in the Orders settings, following these steps below:

  • Go to Dashboard >WooCommerce > Orders > find the order you need to change currency
  • On the Order editing page, select the currency you want to change to in the “Change currency” option
  • Click “Update“
  • (Must do) After the currency of the order is changed successfully, click “Recalculate“
  • Click “Update” again

Note:

  1. Only orders whose payment has not been completed can be changed the currency.
  2. Only currency of orders whose initial base currency is the current site default currency can be changed. E.g. if an order is made in EUR while the default currency was USD at that time. Later the site default currency is changed to, for example, GBP >> That order currency can’t be changed, even if the payment is not completed.

 

 

HOW DOES IT WORK

General

Go to WooCommerce / Settings / Multi Currency / General tab, you can set up the main features of CURCY

  1. Enable: Enable/Disable the plugin
  2. Fixed Price: Activate the “Fixed Price” function to control product prices independently of exchange rates, adding and using your product prices in each currency.
    After enabling this option, follow the steps in this documentation, as well as the note while using “Fixed price”
  3. Don’t use exchange rate: This option makes the price not automatically converted to the exchange rate, even if the fixed price in some currencies is empty.
  4.  Data storage method : On certain servers, some storage methods may cause the selected currency to reset to the default after selection. If this occurs, try using a different storage method.
  5. Switch Currency by JS: When you change the currency using switcher/selector/etc…, it adds this query to the URL: ?wmc-currency={currency}. Enable this option to remove the query. It is good for SEO.
    Note: If you use a multilingual plugin – like TranslatePress – and have the currency changed by the language, this option doesn’t work. It’s the param added for compatibility and can’t be changed otherwise.
  6. Use Cache plugin: Enable this option when you are using any cache plugin on your site to remove the negative impacts of the Cache plugin on Currencies changing/converting on your WooCommerce.
    • AJAX: Sends a request to the server to get the correct price in a particular currency, to overwrite the cached price. Using this option will cause a bit of delay before showing the correct price. It has to work that way to get the correct currency when your site is cached
            a.Reload filter price: Enable this option to reset the price filter when loading via AJAX
            b.Loading price mask: When you use “Override by AJAX” for cache, there’s a while before the correct price is shown. This option adds a “mask” to cover the cached price for the delay
    • JSON: Enabling this option to directly convert the price to all other currencies, and hide the conversion in HTML. Then CURCY detects the cookie currency, looks for the JSON string to see what the currency code is, and overwrites it.
  7. Bot currency: Enable this if you are using a plugin like CTX Feed. It select the currency that you want to show to Bots(web crawler tools) when they crawl your site. If not set, Bots will be treated like normal visitors which means that the auto-detect currency(if enabled) will also apply to them.
    *Note: If the page URL contains wmc-currency or currency parameters (which hold a currency code in uppercase), the value of those parameters will be used instead of this option.
  8. Fixed Structure currency: Sets a fixed currency in your structured data schema, which can be either the default currency or left unset
  9. Currency option:
    • Default Currency: The currency your store will be priced in.
    • Flag: Upload your own custom image to use as the flag. This custom flag will appear in places like shortcodes or switchers where you prefer not to use the default flag
    • Hidden: This option allows you to hide some currencies that you don’t want to appear on the front end. By selecting Yes, you will hide that currency on the front end.
    • Currency: Select currencies here
    • Position: Select the position for the currency symbol.
    • Rate + exchange fee: Rate is the global exchange rate between the default currency and the others. The value of the Rate + Exchange fee can be added in fixed/percentage value. It’s the total value of the exchange rate and the exchange fee added to the product price when users switch currencies.
    • Number of decimals: Choose the number of digits to appear after the decimal separator.
    • Custom symbol: This option allows you to enter a custom symbol for each currency. For example, the American dollar can be displayed as $, USD, $ US…
    • Thousand separator: This option allows you to specify whether you want to use a comma or a dot to separate thousands when displaying numerical values. For example, with the comma option selected, a number like 1,000 would be formatted as 1,000, while with the dot option, it would be formatted as 1.000.
    • Decimal separation: This option allows you to define the symbol used to separate decimal values when displaying numerical figures. You can choose between a comma or a dot to indicate the decimal point. For instance, with the comma option selected, a decimal value like 3.14 might be formatted as 3,14, while with the dot option, it would be displayed as 3.14.
    • Action: Allow you to update the exchange rate of a specific currency, or remove that currency
  10. Remove All Currencies: Remove all existing currencies.
  11. Add All Currencies: Add all currencies to your settings.
  12. Add Currency: This button will duplicate your last currency, then you back to option 8-Currency to select a new currency.
  13. Update All Rates: Update the exchange rates of all your currencies.

Location

Go to WooCommerce / Settings / Multi Currency / Location. Here, you can set up the plugin to automatically select currency based on customers’ country or language.

 

 Auto Detect: No

It shows the default currency, and won’t be changed automatically based on any criteria

 

Auto Detect: Auto select currency

  1.  Switch when user login: Automatically change the displayed currency based on the user’s location when they log in.
    • No
    • Billing Address: Use the user’s billing address to determine currency.
    • Shipping Address: Use the user’s shipping address
    • Billing, if empty, select Shipping
    • Shipping, if empty, select Billing
  2. Geo API: The Geo API detects a customer’s country based on their IP address. If currency doesn’t change correctly based on location, try switching to another API option. MaxMind and Inherited server is the fastest way. And site speed may experience a slight slowdown upon the initial visit if WooCommerce or External elements are utilized.
    • WooCommerce Geolocation: If you choose “WooCommerce”, the 3rd service WooCommerce uses:
    • External: If you choose “External”, we use: http://www.geoplugin.net
    • Inherited from server: Some servers support GEO IP. Only use “Inherited from server” if you go to System status and see that the $_SERVER variable contains one of these parameters HTTP_GEOIP_COUNTRY_CODE, GEOIP_COUNTRY_CODE, HTTP_CF_IPCOUNTRY, MM_COUNTRY_CODE, HTTP_X_COUNTRY_CODE, HTTP_X_QC_COUNTRY and their values show your correct country code
    • MaxMind Geolocation (WooCommerce Integration): If you want to use MaxMind Geolocation, go to WooCommerce > Setting set Default customer location as Geolocate and go to WooCommerce > Setting > Integration set MaxMind License Key to use that API. And the process of fetching location data is managed by WooCommerce, if you’re using MaxMind, and our plugin doesn’t interfere with that
  3. Currency by Country: Choose how currencies are displayed based on a visitor’s country.
    • Enabled: Use the Currency/Countries table to assign currencies to specific countries.
    • Disabled: Currency is based on each country’s native currency without custom mapping.
  4. Currency/Countries: Assign countries to each currency manually as needed. Use “Select All” or “Remove All” to quickly assign or clear countries for each currency. When users visit your site, their country will be detected and the matching currency will be shown.
  5. Get country by currency: Automatically assigns countries whose official currency matches your selected currency.

 

Auto Detect: Initial currency

This feature automatically displays the currency set under ‘Initial Currency’, regardless of the customer’s location. To use it, choose ‘Initial Currency’ as the detection method and select your preferred currency in the ‘Initial Currency Selection’ dropdown. User can still change to other currency

 

Auto Detect: Approximate Price

Show prices in the default currency and an additional one. The plugin will detect customers’ country based on their IP, then display an approximate price in their native country under WooCommerce price. Geo API, Currency by Country and Currency/Countries options have the same function as “Auto select currency”.

  1. Show Approximate price for: Select where you want to show approximate price, other than only show with product price
  2. Approximate price’s label: Add label for Approximate price if you want
  3. Approximate price’s position: Choose a position for the approximate price
  4. Geo API: The Geo API detects a customer’s country based on their IP address. If currency doesn’t change correctly based on location, try switching to another API option. MaxMind and Inherited server is the fastest way. And site speed may experience a slight slowdown upon the initial visit if WooCommerce or External elements are utilized.
    • WooCommerce Geolocation: If you choose “WooCommerce”, the 3rd service WooCommerce uses:
    • External: If you choose “External”, we use: http://www.geoplugin.net
    • Inherited from server: Some servers support GEO IP. Only use “Inherited from server” if you go to System status and see that the $_SERVER variable contains one of these parameters HTTP_GEOIP_COUNTRY_CODE, GEOIP_COUNTRY_CODE, HTTP_CF_IPCOUNTRY, MM_COUNTRY_CODE, HTTP_X_COUNTRY_CODE, HTTP_X_QC_COUNTRY and their values show your correct country code
    • MaxMind Geolocation (WooCommerce Integration): If you want to use MaxMind Geolocation, go to WooCommerce > Setting set Default customer location as Geolocate and go to WooCommerce > Setting > Integration set MaxMind License Key to use that API. And the process of fetching location data is managed by WooCommerce, if you’re using MaxMind, and our plugin doesn’t interfere with that
  5. Currency by Country: Choose how currencies are displayed based on a visitor’s country.
    • Enable: Plugin will detect the customer’s IP address, and the approximate price will be shown with currency based on the country’s respective currency as in the table below the option
    • Disable: Approximate price will be detected based on the country’s official currency
  6. Currency/Countries: Assign countries to each currency manually as needed. Use “Select All” or “Remove All” to quickly assign or clear countries for each currency; and “Get country by currency” to automatically enter the countries that use the corresponding currencies. When users visit your site, their country will be detected and the matching currency will be shown.

 

As in the image below, the approximate price is displayed below the original price, with the label “Approximately”

 

Auto Detect: Language Polylang

Auto-select currency based on Polylang language. You can refer to this video guide.

 

 

Auto Detect: TranslatePress

This feature also allows the currency to change automatically when the site language is switched. After installing and configuring the TranslatePress plugin, you can assign a specific currency to each language in this setting

 

Auto Detect: WPML

Change currency when the user changes languages, just like Polylang. See this tutorial video.

Checkout

This is the video version of configuration guide.

 

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: Enable the multicurrency payment function.
  2. Enable Cart Page: Change currency in the Cart page to check out currency.
  3. Checkout currency: Enable specific currency for checkout and Force currency on payment method
    • Currency: List of your currencies
    • Default: There must always be a currency always available for checkout. Choose one with this option, it does not have to be the site default currency
    • Checkout Currency: Make particular currency available/unavailable in checkout. The selected one in the “Default” option above will always be “Yes”
    • Payment method: Select particular payment method for each currency if you want. The valid payment method will show up correspondingly on the Checkout page. If this field is blank for all currencies, all payment methods will be applied depending on their supported currencies.
    • Yes/No: Bulk change checkout status of all currencies
  4. Currency by Payment method: Assign the currency to the payment method if needed. Currency – after the customer clicks the “Place order” button – will become the corresponding selected one in this table, except for PayPal (there’s a note for this payment method if you enable it)
    a. Option to change currency belong to payment gateway as soon as customer select payment gateway
    b. Option to make currency change work without reloading page
  5. Change currency follow: Make the currency on the Checkout page change based on customer’s shipping/billing country.
    Note: This option cannot be used together with Currency by Payment Method. When used alongside the Currency Switcher on the checkout page, it may not function correctly. Additionally, this option may not work when using the WooCommerce Cart/Checkout Blocks.
  6. Sync checkout currency: When currency is switched on cart/checkout page by the “Change currency follow” option above, also switch currency of the whole current customer session
  7. Display multi currencies: Enable to display both in store pages and checkout page if they are different at the check out page.

Design

Go to WooCommerce / Settings / Multi Currency / Design, this is where you can configure the front-end interface of the plugin.

Currencies Bar

Settings for Currencies Bar – the sidebar currency list, displayed in the left or right middle section of the site, on any pages

  1. Enable/Disable the currencies bar: The bar float on a sidebar of your site, and allows customers to switch currencies.
  2. Checkout page: Enable to hide currencies bar on the checkout page.
  3. Cart Page: Enable to hide currencies bar on the cart page.
  4. Conditional Tags: Configure where the currencies bar will appear by using WooCommerce conditionals Tags and WordPress Conditional tags.
    Important note: To handle WP’s Conditional Tags, this plugin uses eval() which is very dangerous because it allows the execution of arbitrary PHP code. Therefore, please only fill this field with proper conditional tags that are validated and/or provided by trusted developers
  5. Title: Enter the title of the currencies bar.
  6. Position: Select currencies bar position – Left or Right
  7. Desktop: Collapse the currencies bar on desktop. It shows only one selected currency and expands on hover. Disabling this will turn off all related settings – from option 8 to 11 – below.
  8. Click to expand currencies bar: Allows users to expand the Currencies Bar upon clicking the (+) button
  9. Expand button color: Set the icon color for expanding-the-bar button
  10. Expand button background: Set the background color of the expand icon
  11. Expand button opacity: Adjust the transparency of the expand icon
  12. Mobile: Enable it to allow Currencies Bar Collapse on mobile.
  13. Top position: Set the distance from the sidebar center to the top of the screen (use % or px).
  14. Max height(px): Enter the max height for the currencies bar.
  15. Text color: Select the color of the currency bar text.
  16. Sidebar layout: 3 layouts
    • Curved border and no split space: Displays each currency in a dropdown with no gaps between lines, and rounded corners on the dropdown box
    • Split currency line with space: Displays each currency in a dropdown with blank space separating each line for a more spaced-out look
    • Single slide select
  17. Style: Select the style of the currencies bar, there are 4 options for you to select: Default (Currency code), Symbol, Flag,  Flag & Currency Code, and Flag & Currency symbol.
  18. Main color: Configure the color of the currencies bar.
  19. Currency name background: If “Sidebar layout” is “Single slide select”, set up this background color for the currency name when Currencies Bar is collapsed.
  20. Hover color: Currencies bar changes to this color when you hover
  21. Background color: Configure the background color of the currencies bar.

 

Currency selector

Settings for the Currency Price Switcher, which is visible on single product pages only.

  1. Currency Price Switcher: Display a price switcher under product price on product pages, allowing customers to switch the price between currencies. There can be some selections:
    • Not show
    • Flag
    • Flag + Currency code
    • Flag + Price
    • Currency Symbol
    • Currency Code + Name
  2. Switcher layout:  2 layouts
    • Curved border and no split space: Displays each currency in a dropdown with no gaps between lines, and rounded corners on the dropdown box
    • Split currency line with space: Displays each currency in a dropdown with blank space separating each line for a more spaced-out look
  3. Price Switcher Positions: Support the following positions on the single product pages, including:
    • Below title
    • Below price
    • Below excerpt
    • Below add to cart
    • Below meta
    • Below sharing
  4. Click to expand the currency selector: By default, dropdown currency selector including product price switcher, Currency selector widgets(except the Default layout) and Currency selector shortcodes(except [woo_multi_currency]) will expand on hovering. Enable this option if you want them to only expand when clicking on.

 

Currency price collate

  • This feature displays prices in all available currencies except the one currently selected (since it’s already shown).
  • This feature works on both single product pages and product list.
  • This feature uses exchange rates to convert prices and doesn’t support Fixed price feature

  1. Enable: Enable this feature. Display the converted prices of a product across all enabled currencies in one place. This feature helps view and compare how a product is priced in different currencies based on the current exchange rates.
  2. Price collate layout: Adjusts the layout style of prices with multiple currencies displayed together
    • Inline: All currencies in one line
    • Split line: Each currency a line
    • Tooltip
  3. Title: Customize the label shown above the list of converted prices
  4. Single product position: Sets the position of the grouped prices in all currencies on single product pages. Note: this option can be affected by your theme or product template if you use page builder.
    • After title
    • After price
    • After excerpt
    • After add to cart
    • After meta
    • After sharing
  5. Archive position: Sets the position of the grouped prices in all currencies on archive pages

 

Widget, Flag Custom: The option for you to replace a flag with your flag.

Settings for currency tool created by dragging widget under Appearance.

 

Shortcode

Settings for Currency Selectors created by shortcodes.

  1. Text color: Change the text color of the currency shortcode
  2. Background color: Change the background color of the currency shortcode
  3. Activate text color: Change the text color of the currency shortcode when activating
  4. Activate background color: Change the background color of the currency shortcode when activating

 

Custom CSS: Allows you to add your own CSS code to design the currencies bar or widget.

 

 

Price Format

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

  • 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.
  • Add rule: You can add rule for price format following two rules below:

BEAUTY PRICE

* Note: This feature is not applied for shipping. 

Codex

The plugin provides you shortcodes to display currencies exchange widgets, exchange rates on the front-end. Go to WooCommerce / Settings / Multi Currency / Codex to view supported shortcodes.

 

Preview the currency tools below:

 

 

Update

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 the exchange rate will be obtained. Supported APIs are:
    • Default
    • Google Finance
    • Yahoo Finance
    • Cuex
    • Wise: Go to Wise Sandbox to create an account, create an API Token, and insert the API token to the “Wise Api token” field under CURCY’s Update settings.
    • Xe
    • Open exchange rates: Go to Open exchange rates to create an account, create an App ID, and paste it to the “Open exchange rates App ID” field.
    • Exchangerate API: Go to Exchagerate API to create an account, create an API Access Key, and paste it to the “Exchagerate API Access Key” field.
    • Currencyapi: Go to Currency API to create an account, create an API Key, and paste it to the “Currencyapi API Key” field.
    • Custom: If you select “Custom”, you can custom exchange rate via “wmc_get_currency_exchange_rates” hook
  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.

Bulk Fixed Price

Important note: You can’t edit price in default currency with Bulk fixed price function. This price in CSV file is for view only. If you edit it and import back, it will not change the default currency price.

Step 1: Go to WooCommerce / Settings / Multi Currency / Bulk Fixed Price

Step 2: Export product file in CSV format

 

Step 3: Fill or change the fixed regular/sale price of each currency

Step 4: Upload the same file in CSV format to import.

 

 

COMPATIBILITY

 

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
LearnPress ThimPressYesNo Yes No
LearnPressWooCommerce 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
TranslatePress – Multilingual Cozmoslabs, Razvan Mocanu, Madalin Ungureanu, Cristophor Hurduban 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
Extra Product Options for WooCommerce Themehigh Fully compatible
WooCommerce TM 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
WooCommerce PDF Invoices, Packing Slips, Delivery Notes & Shipping Labels WebToffee Fully compatible
Subscriptio – WooCommerce Subscriptions RightPress Fully compatible
Woo Discount Rules Flycart Bulk discount (percentage + fixed), Product adjustment (percentage + fixed), Cart adjustment (percentage discount only)
WooCommerce Product Add-ons WooCommerce Fully compatible
Elementor Elementor.com Fully compatible
REDIS – WooCommerce Dynamic Pricing and Discounts Villatheme
Catna – WooCommerce Name Your Price and Offers Villatheme Convert price + support fixed price for Name your price fields
WooCommerce Boost Sales Villatheme Dynamic price and discount for bundle
WooCommerce Product Add-Ons Ultimate Plugin Republic Fully compatible
CTX Feed Pro WebAppick Fully compatible
WooCommerce Wholesale prices Rymera Web Co Fixed price and Converted price
Advanced Free Shipping Jeroen Sormani Partial compatible
DHL Express Shipping for WooCommerce – Live Rates Octolize Partial compatible
Fancy Product Designer Radykal Partial compatible
Google Listings and Ads WooCommerce Partial compatible
Litespeed Cache LiteSpeed Technologies Partial compatible
Product Designer for WooCommerce WordPress | Lumise King-Theme Partial compatible
Smart Bundle For WooCommerce WooCommerce Partial compatible
Subscriptions for WooCommerce WebToffee Partial compatible
Visual Product Configurator for Woocommerce Lite ORION Partial compatible
WCFM WC Lovers Partial compatible
WooCommerce Payments Automattic Partial compatible
WooCommerce Product Bundles WooCommerce Partial compatible
Woofunnels Order Bump FunnelKit Partial compatible
Advanced Product Fields For Woocommerce Pro StudioWombat Partial compatible
WooCommerce Google Product Feed Ademti Software Ltd Partial compatible
WPC Product Bundles WPClever Partial compatible
Wallet System for WooCommerce WP Swings Partial compatible
PPOM for WooCommerce by N-MEDIA Najeeb Ahmad Partial compatible
WooCommerce Subscriptions WooCommerce Partial compatible
Yith Frequently Bought Together YITH Partial compatible
Yith WooCommerce Points And Rewards Premium YITH Partial compatible
YITH WooCommerce Product Add-Ons YITH Partial compatible
YITH WooCommerce Dynamic Pricing and Discounts YITH Partial compatible
YITH WooCommerce Product Bundles YITH Partial compatible
Advanced Dynamic Pricing for WooCommerce AlgolPlus Partial compatible
Germanized for WooCommerce vendidero Partial compatible
Envia Shipping and Fulfillment WooCommerce Partial compatible
Extra Product Options & Add-Ons for WooCommerce ThemeComplete Partial compatible
WooCommerce Checkout CheckoutWC Partial compatible
WPC Product Bundles for WooCommerce WPClever Partial compatible
WooCommerce Loyalty Points and Rewards Flycart Partial compatible

Override templates

Templates

Template Usage
/woo-multi-currency-selector.php [woo_multi_currency],[woo_multi_currency_plain_vertical_2] shortcode

Follow this guide on how to override VillaTheme plugins’ templates via a theme.

DEVELOPERS

Currency converter functions:

  • $multiCurrencySettings = WOOMULTI_CURRENCY_Data::get_ins(); // get settings

 

  • $wmcCurrencies = $multiCurrencySettings->get_list_currencies(); //get list currency

 

  • $currentCurrency = $multiCurrencySettings->get_current_currency(); // get current currency

 

  • $currentCurrencyRate = floatval( $wmcCurrencies[ $currentCurrency ]['rate'] ); // get rate of current currency

 

  • To get the current currency rate:

    $currentCurrencyRate = 1;
    if(class_exists('WOOMULTI_CURRENCY_Data')) {
    $multiCurrencySettings = WOOMULTI_CURRENCY_Data::get_ins();
    $wmcCurrencies = $multiCurrencySettings->get_list_currencies();
    $currentCurrency = $multiCurrencySettings->get_current_currency();
    $currentCurrencyRate = floatval( $wmcCurrencies[ $currentCurrency ]['rate'] );
    }

Supported Currencies of Payment Methods

It’s crucial to understand that once an order is made, the currencies might switch to those supported by the chosen payment method. Here are some prevalent payment methods and the currencies they accommodate:

Note: For some payment methods, the supported currencies might vary based on the country and the type of advertising account you have. For the most accurate and updated information on supported currencies for each payment method, it’s recommended to visit the official payment method website or the support documentation specific to the service you’re inquiring about:

Payment methods Supported currencies Official Sources
PayPal AUD, BRL, CAD, CNY, CZK, DKK, EUR, HKD, HUF, ILS, JPY, MYR, MXN, TWD, NZD, NOK, PHP, PLN, GBP, SGD, SEK, CHF, THB, USD Link
Stripe USD, AED, AFN, ALL, AMD, ANG, AOA, ARS, AUD, AWG, AZN, BAM, BBD, BDT, BGN, BIF, BMD, BND, BOB, BRL, BSD, BWP, BYN, BZD, CAD, CDF, CHF, CLP, CNY, COP, CRC, CVE, CZK, DJF, DKK, DOP, DZD, EGP, ETB, EUR, FJD, FKP, GBP, GEL, GIP, GMD, GNF, GTQ, GYD, HKD, HNL, HTG, HUF, IDR, ILS, INR, ISK, JMD, JPY, KES, KGS, KHR, KMF, KRW, KYD, KZT, LAK, LBP, LKR, LRD, LSL, MAD, MDL, MGA, MKD, MMK, MNT, MOP, MUR, MVR, MWK, MXN, MYR, MZN, NAD, NGN, NIO, NOK, NPR, NZD, PAB, PEN, PGK, PHP, PKR, PLN, PYG, QAR, RON, RSD, RUB, RWF, SAR, SBD, SCR, SEK, SGD, SHP, SLE, SOS, SRD, STD, SZL, THB, TJS, TOP, TRY, TTD, TWD, TZS, UAH, UGX, UYU, UZS, VND, VUV, WST, XAF, XCD, XOF, XPF, YER, ZAR, ZMW Link
Squarespace ARS, AUD, BRL, GBP, CAD, COP, CZK, DKK, EUR, HKD, INR, IDR, ILS, MYR, MXN, NZD, NOK, PHP, PLN, RUB, SGD, ZAR, SEK, CHF, THB, USD Link
Authorize.net USD, CAD, GBP, EUR, CHF, DKK, NOK, PLN, SEK Link
Apple pay Africa: Morocco, South Africa

Asia-Pacific: Australia, China mainland*, Hong Kong, Japan, Macao, Malaysia, New Zealand, Singapore, South Korea, Taiwan, Vietnam.

Europe: Armeniam, Austria, Azerbaijan, Belarus, Belgium, Bulgaria, Croatia, Cyprus, Czech Republic, Denmark, Estonia, Faroe Islands, Finland, France, Georgia, Germany, Greece, Greenland, Guernsey, Hungary, Iceland, Ireland, Isle of Man, Italy, Kazakhstan, Jersey, Latvia, Liechtenstein, Lithuania, Luxembourg, Malta, Moldova, Monaco, Montenegro, Netherlands, Norway, Poland, Portugal, Romania, San Marino, Serbia, Slovakia, Slovenia, Spain, Sweden, Switzerland, Ukraine, United Kingdom, Vatican City.

Latin America and the Caribbean: Argentina, Brazil, Chile, Colombia, Costa Rica, El Salvador, Guatemala, Honduras, Mexico, Panama, Peru.

Middle East: Bahrain, Israel, Jordan, Kuwait, Palestine, Qatar, Saudi Arabia, United Arab Emirates.

North America: Canada.

 Link
Amazon pay AUD, GBP, DKK, EUR,  HKD, JPY, NZD, NOK, ZAR, SEK, CHF, USD. Link

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.