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

• • Auto Detect: No
  • Auto Detect: Auto select currency
  • Auto Detect: Initial currency
  • Auto Detect: Approximate Price
  • Auto Detect: Language Polylang
  • Auto Detect: TranslatePress Multilingual
  • Auto Detect: WPML

 

 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:
     • ‘ipinfo.io’ => ‘https://ipinfo.io/%s/json‘,
     • ‘ip-api.com‘ => ‘http://ip-api.com/json/%s‘,
   • 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

 

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:
     • ‘ipinfo.io’ => ‘https://ipinfo.io/%s/json‘,
     • ‘ip-api.com‘ => ‘http://ip-api.com/json/%s‘,
   • 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.

 

 

In the 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
     • Reload filter price: Enable this option to reset the price filter when loading via AJAX
     • 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.
   • 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. Update All Rates: Update the exchange rates of all your currencies.
11. Add Currency: This button will duplicate your last currency, then you back to option 8-Currency to select a new currency.
12. Add All Currencies: Add all currencies to your settings.
13. Remove All Currencies: Remove all existing currencies.