Configure currencies

Version: 10.3

To give customers the ability to view product prices in a currency that is meaningful to them, you must configure currencies for your storefront site. For example, you might have a North American storefront that accepts payments in USD and CAD, and a European website that accepts EUR, GBP, and USD. You would then set up a currency set for each storefront unless multiple storefronts use the same currencies, in which case they can share the same currency set.

Note

Orders placed prior to a change of currency are displayed in the currency selected when the original order was placed.

Define the currency set

Currency sets are used, for example, when you have a North American storefront that accepts payments in USD and CAD and a European website that accepts EUR, GBP, and USD. In this case, you set up one currency set (USD, CAD) for the NA storefront and a second currency set (EUR, GBP, USD) for the European website.

  1. In the Content Editor, navigate to sitecore/Commerce/Commerce Control Panel/Shared Settings/Currency Settings.

  2. Right-click Currency Sets and select Insert, Currency Set.

  3. Specify a name for the currency set and click OK.

  4. On the Content tab, in the Commerce Control Panel section, double-click the currencies you want included in the set so that they appear in the Selected list.

  5. In the Default Currency field, select the default currency.

  6. On the ribbon, click Save.

Adjust currency display settings

You can specify display settings for currencies. If no display settings are configured, the default settings specified in the .NET culture definitions.

Display settings are defined in the Commerce Control Panel (/sitecore/Commerce/Commerce Control Panel/Storefront Settings/Storefronts/<site>/Currencies Display Adjustments). Each currency has a default currency symbol and display format but you can also define a symbol and format in the Commerce Control Panel section of the Content tab.

To define currency settings in the Control Panel:

Currencies Display Adjustments on the Commerce Control Panel.

To define currency settings:

  1. In the Content Editor, navigate to storefront in the Commerce Control Panel (sitecore/Commerce/Commerce Control Panel/Storefront Settings/Storefronts/).

  2. Expand the storefront. right-click Currencies Display Adjustments, and select Insert, Currency.

  3. Type a name for the currency and click OK.

  4. On the Content tab, define:

    • Currency Description–provide an meaningful description of the currency.

    • Currency Symbol–the three-digit ISO code or special character, for example USD or $.

    • Currency Symbol Position–select 0 to display $n, 1 to display n$, 2 to display $n, and 3 to display n $

      • 0 to display $n. For example, $4

      • 1 to display n$. For example, 4$

      • 2 to display $ n. For example, $ 4

      • 3 to display n $. For example, 4 $

    • Currency Number Format–type the culture code for the currency. For example:

      • ja - Japanese

      • fr - French (France)

      • da - Danish

      • en-GB - English (Great Britain)

      • en-US - English (United States)

  5. Click Save.

Associate a currency set with a storefront

In order for a storefront to display the currency you need, you must associate the currency set with it.

Note

Ensure you have associated the storefront site with a Commerce Control Panel. To verify, go to sitecore/Content/<tenant>/<site>/Settings/Commerce/Control Panel Configuration.

  1. In the Content Editor, navigate to sitecore/Commerce/Commerce Control Panel/Storefront Settings/Storefronts/<site>.

  2. Select Currency Configuration.

  3. On the Content tab, in the Commerce Control Panel section, select the currency set you want to associate with the storefront.

  4. Save your changes.

The last step is to add the currency to the price cards for the sellable items using the Sitecore Experience Commerce Business Tools.

Do you have some feedback for us?

If you have suggestions for improving this article,