Currency Symbols & Names

Each currency code such as USD or EUR can be represented in several ways, as given in the table below. Be sure to look at the international symbol to see which currency is being translated. For example, the English examples below are for USD. The Symbol and International code will be used in number patterns, as shown in the Examples of Usage. For more information, see Number Patterns.

Type Code Example Examples of Usage Meaning
Symbol USD $
This is to be most commonly understood currency designator next to an amount for this currency in your locale. For example, the localized value of Canadian dollars in US English would likely be "CA$". Showing Swedish krona in Sweden would be "kr", but showing Danish krona in Sweden would be "Dkr", to distinguish it from the Swedish counterpart. The reversed may be used in Danish. Meanwhile showing Bermudan dollar in Sweden, using ISO code "BMD" might be better than "$BM" since it's not a commonly referenced currency. This is an area where you need to think localization, more than translation.

Note: It is not necessary to specify ISO 4217 codes (e.g. "USD") as the symbol merely to ensure that they are available to CLDR clients who want to use them; a developer who specifically wants to use the ISO codes (say, in a table of currency transactions) can get those elsewhere in CLDR, there is no need to "translate" them in a locale. This symbol field is meant for showing an amount with a commonly recognizable and understandable currency designation.
  • Never use the same symbol for two different currencies. If "$" is used for USD, it cannot also be used for AUD.
  • This is one of the areas where the country matters. USD is $ in the default English (which is for US), and other dollar symbols are qualified (AU$, C$, ...). However, in en-AU (Australian English), the choices are switched: $ is AUD, and USD is US$.
Symbol EUR


 12,345.68 kr    
This is an opportunity to provide an even shorter symbol for a currency. When using narrow currency symbols, it it assumed that the context is well known, so it is not necessary for the narrow currency symbol to be unique.   In the example of where Swedish used "Dkr" for Danish krona above, you may use this field for just "kr", and assume that context in its usage will make up for the lack of distinction.
Note: It can be the same as currency-symbol. Many languages use € for Euro in both fields. That's OK if that best represents common usage.
International Code USD n/a
USD 12,345.68
International symbol used in formatting currency amounts. Normally, this is not under translator control, so you won't even see these presented for translation, but they can be specified by the programmer.
International Code EUR n/a


Name USD US Dollar Dollar des États-Unis
Descriptive name of the currency. It should be the most neutral grammatical form for your language, appropriate for menus. Typically this is nominative singular, but the conventions may be different for your language. 
To provide greatest flexibility, this should use capitalization appropriate for the middle of a sentence. CLDR has separate contextTransforms data to specify how this should be programmatically capitalized (if at all) for different contexts such as use in menus, stand-alone use (e.g. a web page title), etc.
Plural form USD US dollar
US dollars
1 US dollar
2 US dollars
Different forms based on plurals used in your language. In this latter case, the items will not appear in menus, and don't need to be capitalized (except for words that require that in your language). See Plurals.

Note: in some cases, the English currency symbol may appear as box, typically because you don't have fonts for all of the characters. This is especially the case for currency symbols recently added to Unicode, such as the following:

image symbol when added
 U+20BC Manat symbol (Azerbaijan) Unicode 7, June 2014
 U+20BD Ruble symbol (Russia...) Unicode 7, June 2014
 U+20BE Lari  symbol (Georgia) Unicode 8, June 2015

Unique Names

Currency names must be unique; the same name can't be used for two different currency codes. When a country replaces a currency, it will get a new code. It will either reuse the name (and the old name needs to be modified), or use a new name. To find out details, go to Detailed Territory-Currency Information to see what currencies are, and which countries they are used in. You can search for the code in square brackets, such as for [MZN] (for Mozambian Metical). A currency is current if it has "∞" in the To column for some country.


  • For a current currency, use the most common name, such as Mozambian Metical.
  • For an obsolete currencies:
    • It may be known by a different name, like Mozambican Escudo. Then there is no problem.
    • If it has the same name as some current currency, include a date range, like Mozambian Metical (1980-2006)


The following general guidelines are used for currency symbols. These guidelines are also subject to the CLDR Currency Process.
  1. If a symbol is not widely recognized around the world (eg shekel ₪)
    1. Where the currency is official in a country, use that symbol in locales with that country (eg IL)
    2. Where the currency would be widely recognized by users of a language, use it in the base language locale (eg he/iw).
    3. Otherwise, use the international currency symbol (eg ILS). This can be done just by omitting the translation.
  2. Otherwise the symbol is widely recognized. If the symbol is used for only one currency (eg €) or widely recognized as being a given currency (eg £):
    1. Use that symbol in root.
    2. If it wouldn't be recognized in particular countries or among particular language users, in those locales/countries use the international currency code (eg EUR) or another replacement (see below). These other symbols have to be listed explicitly, so that they override root.
  3. Otherwise the symbol is used for multiple currencies, so
    1. Use the symbol in the countries that have it as an official currency symbol
    2. Use the symbol in languages where it there is a well-established general understanding that it would mean a particular currency.
  4. Otherwise, typically use international currency code or ("region-code" + symbol) or (symbol + "region-code") (the region is usually a country, but sometimes not) so that it is not ambiguous.
  5. Note that the 3-letter international (ISO 4217) code for every currency is always available to CLDR data consumers, regardless of any other symbols that may be specified for the currency. So it is never necessary to specify the 3-letter code in place of a symbol in order to ensure that the 3-letter code can be used if desired; the choice of when to use a symbol should be governed by the guidelines above.
These are only general guidelines, and may need to be overridden in particular cases. Certain symbols like the dollar sign are particularly tricky, because they are used by a great many countries.