Skip to main content

Managing currencies

If you want to offer your items for sale in different countries, working with various currencies is essential. This page describes the necessary settings you have to carry out in your plentymarkets system for this purpose. plentymarkets allows you to work with a variety of currencies. This is especially useful if you sell your items in several different countries. This page describes the currency settings that affect all clients (stores) in your plentymarkets system. In addition, this page enumerates further currency settings that are needed if only one online store is used.

1. Supported currencies

Your plentymarkets system currently supports the currencies listed in Table 1.

Table 1. Currencies in plentymarkets
ISO Currency


United Arab Emirates dirham


Argentine peso


Australia, Australian dollar


Bulgaria, Bulgarian lev


Bahraini dinar


Brazil, Brazilian real, plural: Reais


Canada, Canadian dollar


Switzerland, Swiss franc


People’s Republic of China, Renminbi


Czech Republic, Czech koruna


Denmark, Danish krone




Great Britain, Pound Sterling


Hong Kong dollar


Croatian kuna


Hungary, forint


Indonesian rupiah


India, Indian rupee


Japan, Japanese yen


Mexico, Mexican peso


Malaysian ringgit


Norway, Norwegian krone


New Zealand dollar


Philippine peso


Poland, zloty


Qatari riyal


Romania, Romanian leu


Russian Federation, ruble


Sweden, Swedish krona


Singapore dollar


Thai baht


Turkey, Turkish lira


New Taiwan dollar


Ukrainian hryvnia


USA, US dollar


Vietnamese dong


Eastern Caribbean dollar


South African rand

2. Converting currencies

Go to Setup » Item » Sales prices and activate the option Currency: Live conversion to determine if the currency conversion in the online store is carried out automatically.
In addition, carry out general currency settings for all incoming orders in the menu Setup » Orders » Payment » Currencies. To do so, proceed as described below.

Converting currencies:

  1. Go to Setup » Orders » Payment » Currencies.

  2. Carry out the settings according to Table 2.

  3. Save the settings.

Table 2. Currency settings
Setting Explanation

Standard currency

Select the System currency from the drop-down list.

Automatically update conversion factors daily

This option specifies whether or not the conversion factors are automatically updated on a daily basis.
Yes = The conversion factors will be updated automatically over night. The option Last automatic update appears below the option for automatic updates of conversion factors.
No = a reload icon is displayed for each currency. Use this icon to manually update the current conversion rates any time.

Last automatic update

Displays the time of the last automatic update of the conversion factors. This field is only visible if the option Automatically update conversion factors daily is set to Yes.

Conversion factor for standard currency into AED, ARS, AUD, …​

The exchange rates are already displayed when opening the menu Setup » Orders » Payment » Currencies, but might need to be updated. Click on Reload next to the respective currency to manually update the exchange rates. Alternatively, set the option Automatically update conversion factors daily to Yes.

3. Defining the system currency

If you are working with several currencies, you have to select one of those currencies as the standard currency of your plentymarkets system. The standard currency is automatically selected as the default currency whenever no other currency is selected. By default, the standard currency in your system is EUR (Euro).
In plentymarkets, orders are always created in the standard currency. In addition, the currency selected by your customers during the order process is always with every single incoming order. If an order was placed in a currency different from the standard currency, the current exchange rate is also saved with the order. Thus, these values are permanently available and can be used to analyse order data or to e.g. send automatic notifications.

Defining the system currency:

  1. Go to Setup » Orders » Payment » Currencies.

  2. Select a currency for the option Standard currency.

  3. Save the settings.

System currency vs. Online store currency

This setting is not necessarily identical to the currency displayed in your online store. You can define a different standard currency for each online store and each language. Further information on these settings are provided below on this manual page.

4. Carrying out settings for the online store

After having carried out the necessary settings regarding currency conversion and system currency, you can determine a standard currency for your online store. In addition, you can decide whether customers are allowed to change the currency during the order process in the online store.
The settings differ depending on whether you run a Ceres or Callisto online store.

4.1. Ceres online stores

If you run your online store using the Ceres plugin in plentymarkets, the Ceres online store page of the manual provides information on all necessary currency settings.

4.2. Callisto online stores

The following chapters explain the necessary currency settings for Callisto online stores.

4.2.1. Callisto: Displaying the currency symbol in the order process

Select whether currencies are displayed as ISO codes or as symbols in the online store. For example, Euro would be displayed as the ISO code EUR or as the symbol. This setting determines how the currency is displayed during the order process and in the My account area in the online store. Template variables and functions are used to display the currency in other areas of the online store.

Displaying the currency symbol in the order process:

  1. Go to Setup » Client » Select client » Online store » Currency.

  2. Select the option Symbol from the Symbol drop-down list.

  3. Save the settings.

4.2.2. Callisto: Defining a standard currency for the online store

If you offer different languages for your online store, you can define a standard currency for every language. If you work with several clients (stores), you can carry out the settings for each store individually. If you want to carry out these settings for a different store, then replace the menu point Standard with the name of the store.

Defining a standard currency for the online store:

  1. Go to Setup » Client » Select client » Online store » Currency.

  2. Select a Standard currency for each language offered in the online store.

  3. Save the settings.

4.2.3. Callisto: Customising the currency displayed in the online store

You can allow your customers to switch from one currency to another. If, for example, you run a German store in which your items are sold in EUR and a Swiss store in which items are sold in CHF, this setting is useful. The following template functions allow customers to switch from one currency to another in the online store:

$Link_Currency (USD)

These template functions are inserted with the following codes:

<a href="$Link_Currency(EUR)">EUR</a>
<a href="$Link_Currency(CHF)">CHF</a>
<a href="$Link_Currency(USD)">USD</a>

Inserting template functions:

  1. Go to CMS » Web design.

  2. Open the folder Layout » PageDesign.

  3. Open a template, e.g. PageDesignContent.

  4. Copy the desired code as provided above and insert it into the desired location within the template.

  5. Save the settings.

Replacing currency symbols

If you previously worked with currency symbols, replace them with the template variable $Currency. The template variable $Currency always contains the currency that is currently selected in the online store.

To top