Skip to content
Salesforce Dictionary - Free Salesforce GlossarySalesforce Dictionary
Full ISO Code entry
How-to guide

Turn on Multiple Currencies and add an ISO 4217 currency

The most common ISO Code task is turning on Multiple Currencies and adding an ISO 4217 currency so records can carry a CurrencyIsoCode. Do this in a sandbox first, because enabling Multiple Currencies cannot be reversed.

By Dipojjal Chakrabarti · Founder & Editor, Salesforce DictionaryLast updated Jun 16, 2026

The most common ISO Code task is turning on Multiple Currencies and adding an ISO 4217 currency so records can carry a CurrencyIsoCode. Do this in a sandbox first, because enabling Multiple Currencies cannot be reversed.

  1. Enable Multiple Currencies

    In Setup, open Company Information, then use the related currency setup to enable Multiple Currencies. Read the warning carefully. The switch is permanent for the org, so confirm you have tested in a sandbox first.

  2. Set the corporate currency

    In Manage Currencies, confirm the corporate currency, which should match your headquarters currency. Every other currency converts to this one for org-wide reporting.

  3. Add an active currency

    Choose New under Active Currencies, pick the ISO 4217 currency you need (for example EUR), set its conversion rate and decimal places, and save. Salesforce validates the code against the standard.

  4. Decide on dated rates

    If you report across currencies over time, enable Advanced Currency Management so reports use Dated Exchange Rates effective on the transaction date rather than a single static rate.

Corporate currencyremember

The single currency, expressed as an ISO 4217 code, that all amounts convert to for org-wide reports. Set it to your headquarters currency.

Active currenciesremember

The list of ISO 4217 codes users can pick on records. Only active codes are valid in the CurrencyIsoCode field and in data loads.

Conversion rate typeremember

Choose static rates (one rate per currency) or Dated Exchange Rates (rates valid for date ranges) via Advanced Currency Management.

Decimal placesremember

Set per currency to match ISO 4217 rules, so JPY shows zero decimals while USD and EUR show two.

Gotchas
  • Enabling Multiple Currencies is a one-way change. There is no supported path back to single-currency, so always pilot in a sandbox.
  • The CurrencyIsoCode on a PriceBookEntry is locked after creation. To change a product price currency you recreate the entry.
  • Data Loader rows without a valid active CurrencyIsoCode fall back to a default and misreport. Include the column and validate the codes first.
  • A currency that is not in the active list is rejected. Add the ISO 4217 code under Manage Currencies before loading or referencing it.

See the full ISO Code entry

ISO Code includes the definition, worked example, deep dive, related terms, and a quiz.