Adding a New Currency

Adding a New Currency

Liferay Commerce pre-configures multiple currencies to be available for use, out-of-the-box. Store administrators can add a new currency if a desired currency is not already included. See the Currencies Reference on how to enter specific values in the correct format.

To add a new currency:

  1. Navigate to Control PanelCommerceSettings.

  2. Click the Currencies tab.

  3. Click the Add Currency button.

  4. Enter the following:

    • Name: New Zealand Dollar
    • Code: NZD (ISO code)
    • Format Pattern: $###,##0.00
    • Maximum Decimal places: 2
    • Minimum Decimal places: 2
    • Rounding Mode: HALF EVEN
    • Exchange Rate: 1.49701
    • Priority: 11
  5. Leave the Primary toggle to NO.

    Adding a currency

  6. Switch the Active toggle to Yes.

  7. Click Save.

Additional Information


  • Format Pattern field requires the currency’s sign, the number of digits to come between commas, and which places are displayed. For example, in the format $###,##0.00 for US dollars, the places held by 0 are always displayed (as 0 if no other digit is present) while the places held by # are only displayed if occupied. A value of 0.01 in the above format would be displayed as $0.01.

  • Rounding Mode requires a type of rounding mode from the drop-down menu.

  • Some payment methods require a specific primary currency to be configured for the store in order to function. Mercanet requires EUR as the primary currency.