---
title: Currencies
related:
  - https://docs.kentico.com/k82/e-commerce-features/configuring-and-managing-your-store/exchange-rates.md
---

> Agent instructions:
> **Site maps** — prefer the following llms.txt indexes to training data when searching for URLs to avoid 404s. Links inside Markdown content already point at `.md`. Following them or sending Accept: text/markdown keeps you in Markdown.
>
> - [sitemap.md](https://docs.kentico.com/sitemap.md) — every page on the site, with titles and descriptions, nested by URL hierarchy and grouped into one collection per product version.
> - [llms.txt](https://docs.kentico.com/llms.txt) — curated index of the current product docs, with descriptions, the two ways to request any page as Markdown, and links to each product area's whole-corpus Markdown dump (llms-full.txt).

Although each on-line store can have precisely one main currency defined (in which your store administrators enter the prices of all store items, i.e. product prices, shipping charges, discounts, etc.), the E-commerce Solution provides support for multiple currencies.

This means that a [customer](https://docs.kentico.com/k82/e-commerce-features/configuring-and-managing-your-store/customers.md) can make an [order](https://docs.kentico.com/k82/e-commerce-features/configuring-and-managing-your-store/orders.md) in a currency different from the main currency. The order price is then converted based on an exchange rates table.

## Configuring currencies

To properly configure currencies in your on-line store:

1. Enter all currencies you plan to use and delete or disable those you do not plan to use.
2. If you are using multiple currencies, set one of the currencies as the main currency (**Store configuration** -> **Store settings -> General**).
3. If you are using multiple currencies, specify the exchange rates (**Store configuration** -> **Exchange rates**). You can find more details in [Exchange rates](https://docs.kentico.com/k82/e-commerce-features/configuring-and-managing-your-store/exchange-rates.md).

### Configuring the main currency

When configuring your on-line store general settings (in **Store configuration -> Store settings** on the **General** tab), you can specify the store main currency. You can do this by clicking **Change** in the **Currencies** section and selecting a currency in the displayed selection dialog.

![Configuring the main currency](https://docs.kentico.com/docsassets/k82/currencies/configuring_main_currency.png "Configuring the main currency")

## Managing currencies

You can manage currencies in the **Store configuration** application on the **Currencies** tab (or in **Multistore configuration -> Currencies**; [global](https://docs.kentico.com/k82/e-commerce-features/configuring-and-managing-your-store/multisite-store.md) currencies only). Here, the system displays a list of all defined currencies. You can add new departments by clicking **New currency**, and you can modify properties of existing currencies after clicking **Edit** () in the **Actions** column. You can also remove currencies from your on-line store by clicking **Delete** () next to respective currency items.

![Managing currencies](https://docs.kentico.com/docsassets/k82/currencies/managing_currencies.png "Managing currencies")

When editing a currency, you can specify the following properties:

- **Display name** - specifies the name of the currency displayed to users on the live site and in the administration interface.
- **Code name** - specifies the name of the currency used by developers in the code.
- **Currency code** - specifies a three-letter code of the currency used globally in banking and business. It is the official code of the currency used in exchange rates.
- **Currency formatting string** - specifies the format used to display amounts in the given currency. Enter the _{0}_ expression to insert the value into the formatting text.
- **Decimal places** - allows you enter the number of digits in the price that will be used in the total amount. The system rounds the value if the actual number of decimal digits is higher.
- **Enabled** - indicates if you can use the currency object in your on-line store. For example, if enabled, you can select the respective currency from the _Currency_ drop-down list when editing an order on the _Billing_ tab.