Template:Infobox currency

Infobox currency

ISO 4217
Code	Template:ISO 4217/code (numeric: Template:ISO 4217/code-to-number)
Subunit	Template:ISO 4217/code-minor-unit

Template documentation[view] [edit] [history] [purge]

Usage

Most commonly used parameters

Most common parameters

{{Infobox currency | name = | local_name = | local_name_lang = | obsolete = | image_1 = | image_title_1 = | image_alt_1 = | iso_code = | issuing_authority = | issuing_authority_website = | date_of_introduction = | date_of_introduction_source = | using_countries = | inflation_rate = | inflation_source_date = | unit = | symbol = | nickname = | plural = <!-- subunits, superunits --> | subunit_ratio_1 = {{frac|1|100}} | subunit_name_1 = | symbol_subunit_1 = | nickname_subunit_1 = | plural_subunit_1 = <!-- banknotes & coins --> | frequently_used_coins = | rarely_used_coins = | frequently_used_banknotes = | rarely_used_banknotes = }}

Euro related (ERM)

Euro & ERM related

{{Infobox currency | local_name = | local_name_lang = | image_1 = | image_title_1 = | alt1 = | iso_code = | issuing_authority = | issuing_authority_website = | date_of_introduction = | date_of_introduction_source = | using_countries = | inflation_rate = | inflation_source_date = | ERM_since = | ERM_fixed_rate_since = | euro_replace_non_cash = | euro_replace_cash = | ERM_fixed_rate = | ERM_band = | unit = euro | subunit_ratio_1 = {{frac|1|100}} | subunit_name_1 = | symbol = [[€]] | plural = | plural_subunit_1 = | frequently_used_coins = | rarely_used_coins = | frequently_used_banknotes = | rarely_used_banknotes = }}

Extensive syntax

Full syntax

{{Infobox currency | name = | local_name = | local_name_lang = | postfix = | local_name2 = | local_name_lang2 = | local_name3 = | local_name_lang3 = | name_abbr = | obsolete =<!-- /yes --> | obsolete_notice = | qid = | image_1 = | image_background_1 = | image_title_1 = | image_width_1 = | image_alt1 = | image_2 = | image_background_2 = | image_title_2 = | image_width_2 = | image_alt2 = | iso_code = | iso_notice = | issuing_authority = | issuing_authority_title = | issuing_authority_website = | date_of_introduction = | date_of_introduction_source = | unofficial_users = | using_countries = | inflation_title = | inflation_rate = | inflation_source_date = | inflation_method = | ERM_since = | ERM_withdraw = | ERM_fixed_rate_since = | euro_replace_non_cash = | euro_replace_cash = | ERM_fixed_rate = | ERM_band = | pegged_with = | pegged_by = | unit = | symbol = | plural = | plural_slavic = | no_plural = | nickname = <!-- superunits: _1 through _5 = --> | superunit_ratio_1 = | superunit_name_1 = | superunit_inline_note_1 = <!-- subunits: _1 through _5 = --> | subunit_ratio_1 = | subunit_name_1 = | subunit_inline_note_1 = | symbol_subunit_1 = | nickname_subunit_1 = | plural_subunit_1 = <!-- banknotes and coins --> | coin_article = | used_coins = | frequently_used_coins = | rarely_used_coins = | banknote_article = | used_banknotes = | frequently_used_banknotes = | rarely_used_banknotes = <!-- production --> | printer = | value = | printer_website = | mint = | mint_website = | footnotes = }}

Parameters

All parameters are optional

Names

• |name= or |currency_name=: overrides the default, the article name ({{PAGENAME}})

For example: "German mark (1871)" → |currency_name=German mark

• |local_name=, |local_name_lang= allows a native name.

Alias names: |currency_name_in_local, local_name1=, |local_name_lang1=

For example: |local_name={{native name|fi|Suomen markka|italics=off}} → Finska markcode: sv is deprecated  (Swedish)

Language codes are in ISO 639 language code.

|postfix, postfix1= will be aded as suffix text to local name #1. Its |local_name_lang1= will not show.

|local_name2, local_name_lang2=, |local_name3, local_name_lang3=, |local_name4, local_name_lang4= allow more pairs of name-language.

All official languages of the issuing authority, plus all that appear on the physical currencies. But exclude languages that appear on motto ("E Pluribus Unum", of the US, "Dieu et mon droit" of UK, if it ever appears) that are in such languages for historical reasons, and regional languages on rotation (the don't-be-stupid clause). It is better missing than to guess. It is ok to be missing. Multiple languages: {{Native name list}}

In some languages, indefinite/definite articles are part of the nouns, such as the North Germanic languages. Use indefinite singular form. Example: Faroese króna. One wouldn't write "le franc français" in French franc's infobox.

See {{native name}} documentation for listing multiple languages. (One line per spelling. Use the {{native name}} or similar templates where appropriate. For example: Euro, dólar australiano (Spanish, Portuguese).

Use capitalization rule as if it is in the middle of a sentence in that language. For example, "franc français", not "Franc français", nor "franc Français".

• |name_abbr= Currency name abbreviation. For example, Can$, $NZ. Can be informal. Is not Template:Code, nor Template:Code. (If provided must be reliable sourtce citable, for example by World Bank.

Active or obsolete

• |obsolete=yes/no. Any other text, like |obsolete=1999, will count as Template:Code .

This will change the headercolor from blue to pink.

• |obsolete-notice=yes/no will add the notice to the bottom (when |obsolete=yes). It never sets or alters the Template:Code status:

This infobox shows the latest status before this currency was rendered obsolete.

ISO 4217 code

• |iso_code=, the formal alpha-3 ISO 4217 code like Template:Code. Some codes are ambiguously active and obslolete, for these, |obsolete=yes/no is decisive.

|iso_code=''None'' (formatted in any form) can be used. This helps the reader clarifying the status of the currency.

Derived values, as defined by ISO 4217Template:ISO 4217/cite are added automatically: Template:Code, Template:Code (see {{ISO 4217/code}}

When |iso_code= is used, the article is categorised in Category:Currencies with ISO 4217 code (0).

When |iso_code=None is used, the article is categorised in Category:Currencies without ISO 4217 code (0).

Otherwise |iso_code=<blank>, the article is not categorised wrt ISO 4217.

Note: as of 1 November 2022, ISO-related parameters Template:Xt! are deprecated and unused. (now automated).

Images

• |image_1=
• |image_title_1=
• |image_background_1= (none) #000000
• |image_width_1= 126 or 252: use a positive integer, no "px". For examples, see East Caribbean dollar, Polish zloty, Chilean peso, Portuguese escudo, Bangladeshi taka
• |image_2=
• |image_title_2=
• |image_background_2=
• |image_width_2=

Pre-euro currencies (ERM)

• |ERM_since= is required for ERM/euro currencies, unless |ERM_withdraw= is used
• |ERM_withdraw= date (for pound sterling and Italian lira)
• |ERM_fixed_rate= "5.94573 mk", (not "1 euro = 5.94573 mk", use symbol if possible)
• |ERM_fixed_rate_since=
• |ERM_band= "15%", not "±15%"
• |euro_replace_non_cash= 1 January 1999
• |euro_replace_cash= 1 January 2002

Currency usage

• |issuing_authority= Central Bank of xyz. If this exists in the infobox, remove duplicate wiki link from the article's "See also" section
• |issuing_authority_title= issuing_authority Central bank Monetary authority, currency board
• |issuing_authority_website= issuing_authority, for example {{URL|www.ecb.eu}}

If this exists in the infobox, remove duplicate link from the article's "External links" section

• |date_of_introduction= 16 August 1965: The date when the issuing authority introduced the medium of currency. Not to be confused with adoption by a country or other entity.
• |date_of_introduction_source= date_of_introduction Name of and reference to the act regarding the introduction of the currency.
• |using_countries= Italicize non-sovereign states, order them as appropriate in the context. Use of {{flag}}, {{flagcountry}}, or {{flagicon}} recommended. See also Wikipedia:Inline templates linking country articles.

Inflation

• |inflation_rate= For additional info, use the next attribute.
• |inflation_source_date= inflation_rate; Prefer central bank data over CIA data. For example:

<ref>[http://www.riksbank.com/templates/Page.aspx?id=12953 Sveriges Riksbank], August 2011</ref>

<ref>[https://www.cia.gov/library/publications/the-world-factbook/fields/2092.html The World Factbook]'', 2010 est.</ref>

• |inflation_method= for eaxmpl, Consumer price index (CPI), or CPI excluding real estate

Pegging

• |pegged_with= Not in combination with |ERM_since=

For example: |pegged_with=euro = 3 units. If the rate is defined that way, do not put the inverse rate like 1 unit = 0.333333 euro.

• |pegged_by= Use ISO 4217 Code if the list gets too long

Unit & symbol

• |unit= unit name, as used locally. e.g., just "dollar" for Australia, Canada etc.
• |plural= emalangeni (use this is the it doesn't follow English grammar)
• |plural_slavic= Put any non-empty value to enable the Slavic notice. For example see Russian ruble
• |no_plural= put any non-empty value to enable the no-plural notice. For example New Taiwan dollar.
• |symbol= unqualified signs as used locally. For example €, £, $. (). Link to the articles of the currency symbols if exist (e.g. dollar sign, pound sign). Do not use abbreviations here, see |name_abbr=.
• |symbol_comment= age, references, notes, language
• |nickname= For example quid, buck/greenback, loonie/huard

Superunit, subunit (1–5)

subunit (like cent)

• |subunit_ratio_1= Template:Code For example Template:Frac, Template:Frac, Template:Frac
• |subunit_name_1= Template:Code Cent (currency), shilling, penny. Do not confuse centavo, centimo, centime, and centesimo.
• |subunit_inline_note_1= Template:Code This is so small that it is not used in practice
• |plural_subunit_1= Template:Code plural_slavic, no_plural, for example aurer (of Iceland). Used for irregular plurals like "pence" (GBP).
• |symbol_subunit_1= Template:Code ¢
• |nickname_subunit__1= Template:Code Matching subunit_name_(1..5} penny

superunit

• |superunit_ratio_1= Template:Code
• |superunit_name_1= Template:Code
• |superunit_inline_note_1= Template:Code

Frequency (coins)

• |used_coins=
• |frequently_used_coins=
• |rarely_used_coins=
• |coin_article= For example |coin_article=[[United States coinage]]

• The |coin_article= parameter without an argument will result in Template:Code in boldface type only if that article exists. If that article does not exist, then "Coins" will be in bold and unlinked.
• Use symbol if possible. But it has to be correct down to the position and the spacing. If you are not sure, fall back to the full name. Central bank websites are a good source for authoritative information.

Correct:

$1, 10¢, £5, 500 Kč

Incorrect:

1$, $ 1, 10 ¢, ¢10, £ 5, 5£, 500Kč, Kč 500

• If the symbol is behind the numeral, then put the symbol after the last one.

Recommended:

20, 50, 100, 200, 500, 1000, 5000 Sk

Not recommended:

20 Sk, 50 Sk, 100 Sk, 200 Sk, 500 Sk, 1000 Sk, 5000 Sk

• Use the representation on the coin/banknote, e.g. if it says "100 cents", then it's "100 cents", not "1 dollar"; if it says "Template:Frac franc", then it's not "50 centimes"
• Use {{frac}}: {{frac|1|4}} → Template:Frac, not 1/4 nor ¼
• If the list involves both the subunits and the main unit, do not add a new line after the subunit. For example,

Recommended:

10p, 20p, 50p, £1

Not recommended:

10p, 20p, 50p
£1

However, add a new line with <br/> after the subunit if and only if the total number of lines remains the same.

Recommended:

10p, 20p, 50p

£1, £2, £5

Not recommended:

10p, 20p, 50p, £1, £2,

£5

• Do not put "and" before the last one, e.g. "1, 5, 10, 20, 50, 100 yuan", not "1, 5, 10, 20, 50, and 100 yuan"
• For large numbers, write like these

• 1000 (no space, no comma)
• 10 000 (with &nbsp;, not a regular space)
• 100 000 (with &nbsp;, not a regular space)
• 1 000 000 (with &nbsp;, not a regular space)
• 10⁷ (or higher) (use {{e}} if the number doesn't start with 1)

Frequent vs. rare comments:

• Smallest coins:

• recently and officially phased out (e.g. 10 and 20 h of Czech koruna, 5 New Zealand cents)
• not used in practice because of low value (1 and 5 South Korean won (maybe it's official now...))

• Denominations in the middle

• Ask yourself this question: if you are given change when conducting a daily activity, and denomination X is required to make a mathematically minimal number of coins and banknotes. Would you receive denomination X? This applies to US 50¢ (historical reason about silver stuff in the 1960s) and 20 New Taiwan dollars (a new denomination lacks government support and campaign).

• Banknotes that are being replaced by coins (e.g. Brazilian real's R$1 coin gradually rendered the R$1 banknote obsolete).
• Large denominations

• Ask yourself this question: do ATMs give this denomination? The answer is no for US$50 and US$100. This question also applies to denominations in the middle, e.g. ATMs in Iceland dispense 500, 1000, and 5000 króna notes, making 2000 króna notes "rarely used".
• Ask yourself this question: When someone buys an electronic product that costs several times the largest denomination and pays in cash, are they likely to use denomination X?

You might be thinking, "why do these simple words "rare" and "frequent" have to turn into these long definitions?" The bottom line is, these definitions describe usage in daily life. The issuance numbers quoted by the central banks/governments have little relevance in this sense, as some denominations may be used for interbank transactions, foreign exchange, in casinos, for tax evasion, by criminal elements, etc.

And only use these attributes when you are very sure. If you are not, fall back to a single list where rarely and frequently are not distinguished.

Frequency (banknotes)

• |used_banknotes=
• |frequently_used_banknotes=
• |rarely_used_banknotes=
• |banknote_article= Banknotes of the Hong Kong dollar

|banknote_article= without an argument will result in Template:Code, if that article exists. If that article does not exist, then "Banknotes" will be in bold and unlinked.

Production

• |printer= Central Printing Shop, Like issuing_authority
• |printer_website= {{URL|www.komsep.com}}
• |mint= Utopian Mint
• |mint_website= {{URL|www.swissmint.ch}}

• |footnotes=

TemplateData

This is the TemplateData for this template used by TemplateWizard, VisualEditor and other tools. See a monthly parameter usage report for Template:Infobox currency in articles based on its TemplateData.

TemplateData for Infobox currency

Template Data

currency [Edit template data] Template parameters This template prefers block formatting of parameters. Parameter Description Type Status name name currency_name no description Unknown optional name_abbr name_abbr no description Unknown optional currency_name_in_local currency_name_in_local no description Unknown optional image_1 image_1 no description Unknown optional image_width_1 image_width_1 no description Unknown optional image_title_1 image_title_1 no description Unknown optional image_alt_1 image_alt_1 alt1 no description String optional image_background_1 image_background_1 no description Unknown optional image_2 image_2 no description Unknown optional image_width_2 image_width_2 no description Unknown optional image_title_2 image_title_2 no description Unknown optional image_alt_2 image_alt_2 alt2 no description String optional image_background_2 image_background_2 no description Unknown optional ISO 4217 code iso_code 3-letter code representing the currency Example USD String suggested ISO 4217 comment iso_comment comment on ISO code Unknown optional ISO reference iso_ref reference (<ref>) for ISO 4217 data String optional unit unit no description Unknown optional plural plural no description Unknown optional plural_slavic plural_slavic no description Unknown optional no_plural no_plural no description Unknown optional symbol symbol no description Example $ String optional symbol comment symbol_comment Is added to the symbol (after space). Can have a reference. Unknown optional nickname nickname no description Unknown optional used_banknotes used_banknotes no description Unknown optional frequently_used_banknotes frequently_used_banknotes no description Unknown optional rarely_used_banknotes rarely_used_banknotes no description Unknown optional used_coins used_coins no description Unknown optional frequently_used_coins frequently_used_coins no description Unknown optional rarely_used_coins rarely_used_coins no description Unknown optional superunit_name_1 superunit_name_1 no description Unknown optional superunit_ratio_1 superunit_ratio_1 no description Unknown optional superunit_ratio_2 superunit_ratio_2 no description Unknown optional superunit_ratio_3 superunit_ratio_3 no description Unknown optional superunit_ratio_4 superunit_ratio_4 no description Unknown optional superunit_ratio_5 superunit_ratio_5 no description Unknown optional superunit_inline_note_1 superunit_inline_note_1 no description Unknown optional superunit_name_2 superunit_name_2 no description Unknown optional superunit_inline_note_2 superunit_inline_note_2 no description Unknown optional superunit_name_3 superunit_name_3 no description Unknown optional superunit_inline_note_3 superunit_inline_note_3 no description Unknown optional superunit_name_4 superunit_name_4 no description Unknown optional superunit_inline_note_4 superunit_inline_note_4 no description Unknown optional superunit_name_5 superunit_name_5 no description Unknown optional superunit_inline_note_5 superunit_inline_note_5 no description Unknown optional subunit_ratio_1 subunit_ratio_1 no description Unknown optional subunit_ratio_2 subunit_ratio_2 no description Unknown optional subunit_ratio_3 subunit_ratio_3 no description Unknown optional subunit_ratio_4 subunit_ratio_4 no description Unknown optional subunit_ratio_5 subunit_ratio_5 no description Unknown optional subunit_name_1 subunit_name_1 no description Unknown optional subunit_inline_note_1 subunit_inline_note_1 no description Unknown optional subunit_name_2 subunit_name_2 no description Unknown optional subunit_inline_note_2 subunit_inline_note_2 no description Unknown optional subunit_name_3 subunit_name_3 no description Unknown optional subunit_inline_note_3 subunit_inline_note_3 no description Unknown optional subunit_name_4 subunit_name_4 no description Unknown optional subunit_inline_note_4 subunit_inline_note_4 no description Unknown optional subunit_name_5 subunit_name_5 no description Unknown optional subunit_inline_note_5 subunit_inline_note_5 no description Unknown optional plural_subunit_1 plural_subunit_1 no description Unknown optional plural_subunit_2 plural_subunit_2 no description Unknown optional plural_subunit_3 plural_subunit_3 no description Unknown optional plural_subunit_4 plural_subunit_4 no description Unknown optional plural_subunit_5 plural_subunit_5 no description Unknown optional symbol_subunit_1 symbol_subunit_1 no description Unknown optional symbol_subunit_2 symbol_subunit_2 no description Unknown optional symbol_subunit_3 symbol_subunit_3 no description Unknown optional symbol_subunit_4 symbol_subunit_4 no description Unknown optional symbol_subunit_5 symbol_subunit_5 no description Unknown optional nickname_subunit_1 nickname_subunit_1 no description Unknown optional nickname_subunit_2 nickname_subunit_2 no description Unknown optional nickname_subunit_3 nickname_subunit_3 no description Unknown optional nickname_subunit_4 nickname_subunit_4 no description Unknown optional nickname_subunit_5 nickname_subunit_5 no description Unknown optional banknote_article banknote_article no description Unknown optional coin_article coin_article no description Unknown optional date_of_introduction date_of_introduction no description Unknown optional date_of_introduction_source date_of_introduction_source no description Unknown optional using_countries using_countries no description Unknown required unofficial_users unofficial_users no description Unknown optional issuing_authority_title issuing_authority_title no description Unknown optional issuing_authority issuing_authority no description Unknown optional issuing_authority_website issuing_authority_website no description URL optional printer printer no description Unknown optional printer_website printer_website no description Unknown optional mint mint no description Unknown optional mint_website mint_website no description Unknown optional inflation_rate inflation_rate no description Unknown optional value value no description Unknown optional pegged_with pegged_with no description Unknown optional pegged_by pegged_by no description Unknown optional inflation_title inflation_title no description Unknown optional inflation_source_date inflation_source_date no description Unknown optional inflation_method inflation_method no description Unknown optional ERM_since ERM_since no description Unknown optional ERM_withdraw ERM_withdraw no description Unknown optional ERM_fixed_rate_since ERM_fixed_rate_since no description Unknown optional ERM_band ERM_band no description Unknown optional ERM_fixed_rate ERM_fixed_rate no description Unknown optional euro_replace_non_cash euro_replace_non_cash no description Unknown optional euro_replace_cash euro_replace_cash no description Unknown optional replaced_currency replaced_currency no description Unknown optional date_of_withdrawal date_of_withdrawal no description Unknown optional date_of_withdrawal_source date_of_withdrawal_source no description Unknown optional replaced_by_currency replaced_by_currency no description Unknown optional Is obsolete obsolete "Yes" (or "1999") will stat the currency is Obsolete ("no"=active currency) Default no String optional Obsolete footnote obsolete_notice Will add footnote "Infobox shows status before going obsolete". Only when obsolete=yes. Boolean optional footnotes footnotes no description Unknown optional QID qid Wikidata QID when this currency is not the article item Unknown optional local_name_format local_name_format no description Unknown optional local_name_lang local_name_lang no description Unknown optional local_name_lang1 local_name_lang1 no description Unknown optional local_name local_name no description Unknown optional local_name1 local_name1 no description Unknown optional postfix postfix no description Unknown optional postfix1 postfix1 no description Unknown optional local_name_lang2 local_name_lang2 no description Unknown optional local_name2 local_name2 no description Unknown optional local_name_lang3 local_name_lang3 no description Unknown optional local_name3 local_name3 no description Unknown optional local_name_lang4 local_name_lang4 no description Unknown optional local_name4 local_name4 no description Unknown optional

Tracking categories

• Public

• Template:Cl:

Category:Currencies with ISO 4217 code (0)

Category:Currencies without ISO 4217 code (0) per |iso_code=none, or {{Infobox cryptocurrency}}

• Maintenance

Category:Pages using Infobox currency with unknown parameters (1)

Category:Pages using ISO 4217 currency to check (0) (tracking, hidden)

Category:Pages using Infobox currency to check (0)

Category:Infobox currency with an unlinked website (0) -- website checking

ISO 4217 Subtemplates used

• {{ISO 4217/code}}
• {{ISO 4217/code-minor-unit}}
• {{ISO 4217/code-to-number}}

{{ISO 4217/code-none}}

See also

• {{ISO 4217/overview}} -- backgrond overview of all ISO data
• {{Infobox currency sign}}
• {{Infobox cryptocurrency}}
• {{Infobox currency/overview}} Currency by ISO 4217, Wikidata, enwiki

Template:TPU

The above documentation is transcluded from Template:Infobox currency/doc. (edit | history)
Editors can experiment in this template's sandbox (create | mirror) and testcases (create) pages.
Add categories to the /doc subpage. Subpages of this template.