What is the most important tip for working with ISO Code?

Quick Fact: Activating Multiple Currencies in Salesforce is one-way. Once enabled, the org cannot revert. Test the rollout in a sandbox before flipping the switch in production.

Core CRMIntermediate

ISO Code

Q: What is an ISO Code in Salesforce?

ISO Codes are standard three-letter currency identifiers like USD, EUR, GBP used throughout Salesforce multi-currency configurations.

Q: Can you disable multi-currency once it's enabled?

Enabling multi-currency is one-way. You can't disable it once enabled, so the decision should be made carefully.

Q: What are dated exchange rates used for?

Dated exchange rates ensure historical records use the correct rate for their date, not just the current rate.

ISO Code in Salesforce most commonly refers to the three-letter currency code defined by ISO 4217 (USD, EUR, GBP, JPY, INR) that the platform uses for multi-currency operations.

Hear it

§ 01

Definition

ISO Code in Salesforce most commonly refers to the three-letter currency code defined by ISO 4217 (USD, EUR, GBP, JPY, INR) that the platform uses for multi-currency operations. It also refers to ISO 3166 country codes (US, GB, DE) used in address fields and to the ISO language codes (en_US, fr_FR, de_DE) used in user-language and translation contexts. In each case, Salesforce relies on the international standard to normalize text values across the platform, integrations, and customer-facing data.

The currency ISO code is the most operationally important: it drives the currency picker on financial fields, the multi-currency conversion exchange rates, and the foreign-key relationships in DatedConversionRate, OpportunityCurrency, and any other multi-currency feature. Country and language codes drive user preferences, internationalization of content, and the Translation Workbench. Working with ISO codes correctly is the foundation of any global Salesforce deployment; using the wrong code (3-letter US instead of USA, or en instead of en_US) breaks integration data flows and produces silent display bugs.

§ 02

The three ISO standards Salesforce relies on

ISO 4217 currency codes

ISO 4217 defines three-letter currency codes for every world currency. Salesforce uses these codes in the CurrencyIsoCode field, available on every multi-currency-enabled object. Common codes: USD (US Dollar), EUR (Euro), GBP (British Pound), JPY (Japanese Yen), INR (Indian Rupee), CNY (Chinese Yuan). The platform supports adding any ISO 4217 code as an active currency under Setup, Manage Currencies.

Multi-currency mechanics

When multi-currency is enabled, every currency field has a CurrencyIsoCode picklist alongside the amount. Salesforce stores the amount in the chosen currency and applies the DatedConversionRate table to convert to the corporate currency for reports. The platform supports both static conversion rates (one rate per currency, updated periodically) and dated conversion rates (rates valid for specific date ranges).

ISO 3166 country codes

ISO 3166 defines two- and three-letter country codes. Salesforce uses the two-letter code (US, GB, DE, IN) in standard address fields when State and Country Picklists are enabled. The codes integrate with shipping, tax, and compliance integrations that key off country. Without State and Country Picklists, the country field is free-text and integrations have to clean up variant spellings (USA, U.S.A., United States, United States of America).

ISO 639 language codes

Salesforce uses ISO 639 (with country-suffix combinations from ISO 3166) for the User.LanguageLocaleKey field: en_US, en_GB, fr_FR, de_DE, es_MX. These codes drive the language of the UI, the locale-specific formatting of dates and numbers, and the Translation Workbench''s target language lists. The Translation Workbench requires source-target language pairs in the right ISO format.

Integration data hygiene

Integrations with external systems (ERP, marketing automation, finance) must agree on the ISO codes for currency, country, and language. The most common integration bug is mismatched codes: an external system sending US Dollar as USD when Salesforce expects en_US-formatted strings, or a Salesforce export sending US when the destination expects USA. Document the agreed ISO code per integration field.

Enabling and adding currencies

Setup, Company Information, enable Multiple Currencies. The org permanently switches to multi-currency mode (one-way). Setup, Manage Currencies, add the active currencies you need, set the corporate currency, configure the conversion rate management approach (static vs. dated). Adding a currency requires the ISO 4217 code; Salesforce validates against the standard.

Dated Exchange Rates

DatedConversionRate is the standard object that stores the exchange rate per currency per date range. When enabled (advanced currency management), reports use the rate effective at the transaction date rather than the current rate. This matches accounting standards better than static rates and is the recommended setup for any org with cross-currency reporting needs.

§ 03

Set up multi-currency with ISO codes

Multi-currency setup is one-way; plan carefully before flipping the switch.

Enable Multiple Currencies
Setup, Company Information, check Activate Multiple Currencies. The change is permanent.
Set the corporate currency
Setup, Manage Currencies, set the org''s reporting currency (USD for US orgs, GBP for UK orgs).
Add active currencies
Add every currency the org transacts in via Manage Currencies, using the ISO 4217 three-letter code.
Enable Advanced Currency Management (optional)
Setup, Manage Currencies, enable Advanced Currency Management. This activates dated exchange rates.
Configure exchange rate management
Update rates daily, weekly, or monthly. Most orgs integrate with a financial-data feed (Bloomberg, Reuters) for daily rates.
Test multi-currency reporting
Build a cross-currency report grouping by CurrencyIsoCode and verify the conversion math produces the expected corporate-currency totals.

Gotchas

Activating Multiple Currencies is one-way. Test in a sandbox first; production cannot revert.
Dated Conversion Rates are an advanced feature that affects historical report values. Plan the cutover carefully if migrating from static rates.
Integration data must agree on ISO codes. The most common bug is mismatched country codes between Salesforce and ERP; agree on the standard upfront.
The Translation Workbench requires specific ISO language codes. Make sure target locales use the right en_GB-style format, not just en.

Trust & references

Sources

Cross-checked against the following references.

Multi-Currency SetupSalesforce Help
State and Country PicklistsSalesforce Help

Official documentation

Straight from the source - Salesforce's reference material on ISO Code.

CurrencyType ObjectSalesforce Developers

Was this entry helpful?

Help us write better definitions. Quick reactions or detailed edit suggestions.

About the Author

Dipojjal Chakrabarti is a B2C Solution Architect with 29 Salesforce certifications and over 13 years in the Salesforce ecosystem. He runs salesforcedictionary.com to help admins, developers, architects, and cert/interview candidates sharpen their fundamentals. More about Dipojjal.

Test your knowledge

Q1. What is an ISO Code in Salesforce?

Q2. Can you disable multi-currency once it's enabled?

Q3. What are dated exchange rates used for?

Discussion

Loading…

Loading discussion…

Back to Dictionary