Template:Infobox currency/doc

From WWII Archives

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 mark (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 <syntaxhighlight lang="text" class="" id="" style="" inline="1">ISO 4127 code</syntaxhighlight>, nor <syntaxhighlight lang="text" class="" id="" style="" inline="1">symbol</syntaxhighlight>. (If provided must be reliable sourtce citable, for example by World Bank.[1]

Active or obsolete

  • |obsolete=yes/no. Any other text, like |obsolete=1999, will count as <syntaxhighlight lang="text" class="" id="" style="" inline="1">yes (is obsolete)</syntaxhighlight> .
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 <syntaxhighlight lang="text" class="" id="" style="" inline="1">is-obsolete</syntaxhighlight> 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 <syntaxhighlight lang="text" class="" id="" style="" inline="1">EGP, EUR, USD</syntaxhighlight>. 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 4217[2] are added automatically: <syntaxhighlight lang="text" class="" id="" style="" inline="1">ISO Numeric Code</syntaxhighlight>, <syntaxhighlight lang="text" class="" id="" style="" inline="1">ISO Minor Unit</syntaxhighlight> (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 iso_number, iso_exponent, iso_decimals are deprecated and unused. (now automated).
  • |iso_comment=
  • |iso_ref=

Images

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>

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= <syntaxhighlight lang="text" class="" id="" style="" inline="1">_5</syntaxhighlight> For example 1100, 120, 1240
  • |subunit_name_1= <syntaxhighlight lang="text" class="" id="" style="" inline="1">_5</syntaxhighlight> Cent (currency), shilling, penny. Do not confuse centavo, centimo, centime, and centesimo.
  • |subunit_inline_note_1= <syntaxhighlight lang="text" class="" id="" style="" inline="1">_5</syntaxhighlight> This is so small that it is not used in practice
  • |plural_subunit_1= <syntaxhighlight lang="text" class="" id="" style="" inline="1">_5</syntaxhighlight> plural_slavic, no_plural, for example aurer (of Iceland). Used for irregular plurals like "pence" (GBP).
  • |symbol_subunit_1= <syntaxhighlight lang="text" class="" id="" style="" inline="1">_5</syntaxhighlight> ¢
  • |nickname_subunit__1= <syntaxhighlight lang="text" class="" id="" style="" inline="1">_5</syntaxhighlight> Matching subunit_name_(1..5} penny
superunit
  • |superunit_ratio_1= <syntaxhighlight lang="text" class="" id="" style="" inline="1">_5</syntaxhighlight>
  • |superunit_name_1= <syntaxhighlight lang="text" class="" id="" style="" inline="1">_5</syntaxhighlight>
  • |superunit_inline_note_1= <syntaxhighlight lang="text" class="" id="" style="" inline="1">_5</syntaxhighlight>

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 <syntaxhighlight lang="text" class="" id="" style="" inline="1">[[Coins of the {{{currency_name|{{PAGENAMEBASE}}}}}|Coins]]</syntaxhighlight> 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 "12 franc", then it's not "50 centimes"
  • Use {{frac}}: {{frac|1|4}}14, 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)
  • 107 (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)

|banknote_article= without an argument will result in <syntaxhighlight lang="text" class="" id="" style="" inline="1">[[Banknotes of the {{{currency_name|{{PAGENAMEBASE}}}}}|Banknotes]]</syntaxhighlight>, 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

Template parameters

This template prefers block formatting of parameters.

ParameterDescriptionTypeStatus
namename currency_name

no description

Unknownoptional
name_abbrname_abbr

no description

Unknownoptional
currency_name_in_localcurrency_name_in_local

no description

Unknownoptional
image_1image_1

no description

Unknownoptional
image_width_1image_width_1

no description

Unknownoptional
image_title_1image_title_1

no description

Unknownoptional
image_alt_1image_alt_1 alt1

no description

Stringoptional
image_background_1image_background_1

no description

Unknownoptional
image_2image_2

no description

Unknownoptional
image_width_2image_width_2

no description

Unknownoptional
image_title_2image_title_2

no description

Unknownoptional
image_alt_2image_alt_2 alt2

no description

Stringoptional
image_background_2image_background_2

no description

Unknownoptional
ISO 4217 codeiso_code

3-letter code representing the currency

Example
USD
Stringsuggested
ISO 4217 commentiso_comment

comment on ISO code

Unknownoptional
ISO referenceiso_ref

reference (<ref>) for ISO 4217 data

Stringoptional
unitunit

no description

Unknownoptional
pluralplural

no description

Unknownoptional
plural_slavicplural_slavic

no description

Unknownoptional
no_pluralno_plural

no description

Unknownoptional
symbolsymbol

no description

Example
$
Stringoptional
symbol commentsymbol_comment

Is added to the symbol (after space). Can have a reference.

Unknownoptional
nicknamenickname

no description

Unknownoptional
used_banknotesused_banknotes

no description

Unknownoptional
frequently_used_banknotesfrequently_used_banknotes

no description

Unknownoptional
rarely_used_banknotesrarely_used_banknotes

no description

Unknownoptional
used_coinsused_coins

no description

Unknownoptional
frequently_used_coinsfrequently_used_coins

no description

Unknownoptional
rarely_used_coinsrarely_used_coins

no description

Unknownoptional
superunit_name_1superunit_name_1

no description

Unknownoptional
superunit_ratio_1superunit_ratio_1

no description

Unknownoptional
superunit_ratio_2superunit_ratio_2

no description

Unknownoptional
superunit_ratio_3superunit_ratio_3

no description

Unknownoptional
superunit_ratio_4superunit_ratio_4

no description

Unknownoptional
superunit_ratio_5superunit_ratio_5

no description

Unknownoptional
superunit_inline_note_1superunit_inline_note_1

no description

Unknownoptional
superunit_name_2superunit_name_2

no description

Unknownoptional
superunit_inline_note_2superunit_inline_note_2

no description

Unknownoptional
superunit_name_3superunit_name_3

no description

Unknownoptional
superunit_inline_note_3superunit_inline_note_3

no description

Unknownoptional
superunit_name_4superunit_name_4

no description

Unknownoptional
superunit_inline_note_4superunit_inline_note_4

no description

Unknownoptional
superunit_name_5superunit_name_5

no description

Unknownoptional
superunit_inline_note_5superunit_inline_note_5

no description

Unknownoptional
subunit_ratio_1subunit_ratio_1

no description

Unknownoptional
subunit_ratio_2subunit_ratio_2

no description

Unknownoptional
subunit_ratio_3subunit_ratio_3

no description

Unknownoptional
subunit_ratio_4subunit_ratio_4

no description

Unknownoptional
subunit_ratio_5subunit_ratio_5

no description

Unknownoptional
subunit_name_1subunit_name_1

no description

Unknownoptional
subunit_inline_note_1subunit_inline_note_1

no description

Unknownoptional
subunit_name_2subunit_name_2

no description

Unknownoptional
subunit_inline_note_2subunit_inline_note_2

no description

Unknownoptional
subunit_name_3subunit_name_3

no description

Unknownoptional
subunit_inline_note_3subunit_inline_note_3

no description

Unknownoptional
subunit_name_4subunit_name_4

no description

Unknownoptional
subunit_inline_note_4subunit_inline_note_4

no description

Unknownoptional
subunit_name_5subunit_name_5

no description

Unknownoptional
subunit_inline_note_5subunit_inline_note_5

no description

Unknownoptional
plural_subunit_1plural_subunit_1

no description

Unknownoptional
plural_subunit_2plural_subunit_2

no description

Unknownoptional
plural_subunit_3plural_subunit_3

no description

Unknownoptional
plural_subunit_4plural_subunit_4

no description

Unknownoptional
plural_subunit_5plural_subunit_5

no description

Unknownoptional
symbol_subunit_1symbol_subunit_1

no description

Unknownoptional
symbol_subunit_2symbol_subunit_2

no description

Unknownoptional
symbol_subunit_3symbol_subunit_3

no description

Unknownoptional
symbol_subunit_4symbol_subunit_4

no description

Unknownoptional
symbol_subunit_5symbol_subunit_5

no description

Unknownoptional
nickname_subunit_1nickname_subunit_1

no description

Unknownoptional
nickname_subunit_2nickname_subunit_2

no description

Unknownoptional
nickname_subunit_3nickname_subunit_3

no description

Unknownoptional
nickname_subunit_4nickname_subunit_4

no description

Unknownoptional
nickname_subunit_5nickname_subunit_5

no description

Unknownoptional
banknote_articlebanknote_article

no description

Unknownoptional
coin_articlecoin_article

no description

Unknownoptional
date_of_introductiondate_of_introduction

no description

Unknownoptional
date_of_introduction_sourcedate_of_introduction_source

no description

Unknownoptional
using_countriesusing_countries

no description

Unknownrequired
unofficial_usersunofficial_users

no description

Unknownoptional
issuing_authority_titleissuing_authority_title

no description

Unknownoptional
issuing_authorityissuing_authority

no description

Unknownoptional
issuing_authority_websiteissuing_authority_website

no description

URLoptional
printerprinter

no description

Unknownoptional
printer_websiteprinter_website

no description

Unknownoptional
mintmint

no description

Unknownoptional
mint_websitemint_website

no description

Unknownoptional
inflation_rateinflation_rate

no description

Unknownoptional
valuevalue

no description

Unknownoptional
pegged_withpegged_with

no description

Unknownoptional
pegged_bypegged_by

no description

Unknownoptional
inflation_titleinflation_title

no description

Unknownoptional
inflation_source_dateinflation_source_date

no description

Unknownoptional
inflation_methodinflation_method

no description

Unknownoptional
ERM_sinceERM_since

no description

Unknownoptional
ERM_withdrawERM_withdraw

no description

Unknownoptional
ERM_fixed_rate_sinceERM_fixed_rate_since

no description

Unknownoptional
ERM_bandERM_band

no description

Unknownoptional
ERM_fixed_rateERM_fixed_rate

no description

Unknownoptional
euro_replace_non_casheuro_replace_non_cash

no description

Unknownoptional
euro_replace_casheuro_replace_cash

no description

Unknownoptional
replaced_currencyreplaced_currency

no description

Unknownoptional
date_of_withdrawaldate_of_withdrawal

no description

Unknownoptional
date_of_withdrawal_sourcedate_of_withdrawal_source

no description

Unknownoptional
replaced_by_currencyreplaced_by_currency

no description

Unknownoptional
Is obsoleteobsolete

"Yes" (or "1999") will stat the currency is Obsolete ("no"=active currency)

Default
no
Stringoptional
Obsolete footnoteobsolete_notice

Will add footnote "Infobox shows status before going obsolete". Only when obsolete=yes.

Booleanoptional
footnotesfootnotes

no description

Unknownoptional
QIDqid

Wikidata QID when this currency is not the article item

Unknownoptional
local_name_formatlocal_name_format

no description

Unknownoptional
local_name_langlocal_name_lang

no description

Unknownoptional
local_name_lang1local_name_lang1

no description

Unknownoptional
local_namelocal_name

no description

Unknownoptional
local_name1local_name1

no description

Unknownoptional
postfixpostfix

no description

Unknownoptional
postfix1postfix1

no description

Unknownoptional
local_name_lang2local_name_lang2

no description

Unknownoptional
local_name2local_name2

no description

Unknownoptional
local_name_lang3local_name_lang3

no description

Unknownoptional
local_name3local_name3

no description

Unknownoptional
local_name_lang4local_name_lang4

no description

Unknownoptional
local_name4local_name4

no description

Unknownoptional

Tracking categories

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 (0)
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-none}}

See also

Parameter usage report for Template:Infobox currency.
  1. World Bank Style Guide pp134–139)
  2. ISO 4217 Standard definition:
    • "Data Standards, ISO 4217 - Currency Code Maintenance: Get the Correct Currency Code". www.six-group.com. SIX Group. 2022-10-01.