You can find the menu item Currencies by clicking on Settings > Shop, in the menu of your administration on the left.

In this tab you will find all relevant information and data concerning your currencies for your sales channels. 
Here you have the option of managing them, creating new currencies or removing existing ones.


The overview shows you all the currencies already configured for your shop, including all the relevant information.

You can edit (2) or remove (3) these currencies using the context menu (1).

The factor is defined by the top system currency. The configuration of this currency should always remain unchanged.

Create a new currency

To create a new currency click on the Add currency button. The creation of currencies is divided into three areas. Settings, price roundings and countries.


In the Settings section, you first make the basic settings for the currency.

Name (1): Enter the name of the currency in this field, e.g. Euro.
ISO code (2): Enter the ISO code of your currency here. You can find an overview of the valid ISO codes here: list of currency codes
Short name (3): In this field you enter a short name for your currency, e.g. the ISO code EUR. Please note that the short name must consist of exactly three letters.
Symbol (4): In Symbol you enter the symbol of your currency, e.g. € for Euro.
Factor (5): Here you enter the factor of your currency, which is defined by the standard currency in your system, e.g. 1.17085 for the US dollar.

The factor is defined by the system standard currency.
When assigned, this factor converts the stored values of the system standard currency by using the factor and thereby displays the adjusted prices with the assigned currency in the frontend.

By pressing the save button you create this currency with the given configuration.

Currencies that you create must always be maintained in the system standard language, which is why the language selection is greyed out here.

Price rounding

For each currency you can define how the prices in the shopping cart and in the subtotals should be rounded. This is done in the price rounding section.

Decimal places (1): For the decimal places you can enter a number (e.g. 2) to indicate how many decimal places should be taken into account in the calculation in the shopping basket.
Intervall (2): With the intervals you can define how the further decimal places should be rounded. For example, you can take into account markets where the minimum unit of account is smaller than the lowest physical denomination of currency.

Make sure that your connected service providers and extensions support this configuration to avoid accounting problems. 

Round for net customers too (3): Check this box if you want to apply the specified rounding for the positions also for net customers.
Grand total (4): In the Grand total area you can make the settings 1-3 again separately for the grand total amount of the shopping cart.


In the Country section you have the option to set different price rounding settings for individual countries. Clicking on the Add country button opens the following mask for setting the different price rounding settings.

Country (1): Select here the country for which different price rounding settings are to be made.
Price rounding(2): As in the Price Rounding section, you can make different price rounding settings here for the items as well as for the total amount of the shopping cart.

Edit an existing currency

The edit mode, which you can open by clicking on the context menu in the currency overview, allows you to edit existing currencies. Here you have the same settings as when creating a new currency.

To add translations to your currencies change the language (1). Now you can enter your translation, which will then be displayed in the designated areas in the storefront.

Remove a currency

Currencies could only be removed in a self-hosted environment.

You can only remove a currency if it is no longer used anywhere.
Therefore, make sure that you have no longer assigned this currency to any of your sales channels, etc.
If you try to do this anyway, the system will give you a message that shows you where this currency is still being used.


The display of the currency symbols or formatting of the price structure (price + currency symbol) depends on the selected language. The ISO code selected in the language is especially important.

Example: When the German language is selected, the currency symbol for US dollars is displayed to the right of the price and then looks like this: "499.99 $". However, if the English language is selected, the formatting changes to the following "US$499.99".

Was this article helpful?