---
title: "Currency"
manual: "Cart"
version: "12.1"
permalink: "https://docs.typo3.org/permalink/extcode/cart:currency@12.1"
source: "Administrator/Configuration/Currency/Index.rst"
rendered: "2026-11-14T23:50:30+00:00"
---

# Currency {#currency}

## Currency Format {#currency-format}

To make the templates a bit easier to use, TypoScript can be used to configure
the format specifications for the price output.
These TypoScript specifications are then used in the `<cart:format.currency>`
ViewHelper.

**EXT:cart/Configuration/TypoScript/constants.typoscript**

```typoscript
plugin.tx_cart {
    settings {
        format {
            currency {
                currencySign       = &euro;
                decimalSeparator   = ,
                thousandsSeparator = .
                prependCurrency    = false
                separateCurrency   = true
                decimals           = 2
            }
        }
    }
}
```

## Currency Translation {#adminstration-currency-translation}

If you want to allow the user to display the prices in a different currency
in the store, you can configure this via TypoScript.

> [!NOTE]
> At the moment there is no automatism to update the factor and adjust it to a
> current value. With a scheduler task, it should be possible to connect a
> corresponding service quite quickly.

**EXT:cart/Configuration/TypoScript/setup.typoscript**

```typoscript
plugin.tx_cart {
    settings {
        currencies {
            preset = 1
            options {
                1 {
                    code = EUR
                    sign = €
                    translation = 1.00
                }
            }
        }
    }
}
```

### plugin.tx_cart.settings.currency {#plugin-tx-cart-settings-currency}

-   **preset**

    -   *Type:* int
    -   *Default:* 1

    Defines which of the existing currencies will be the default currency
    of a new shopping cart.

-   **options.\<n>**

    -   *Type:* array

    List of the different currencies available.

-   **options.\<n>.code**

    -   *Type:* array
    -   *Default:* EUR

    Three-digit international currency code according
    to [ISO 4217 (Wikipedia)](https://de.wikipedia.org/wiki/ISO_4217).
    This is among other things for different payment providers and as a
    parameter for changing the currency in the shopping cart.

-   **options.\<n>.sign**

    -   *Type:* array
    -   *Default:* €

    Currency symbol, if available, for the currency.

-   **options.\<n>.translation**

    -   *Type:* array
    -   *Default:* 1.0

    Currency conversion factor.
    The price of the products is divided by this factor.
