Template:Infobox currency/doc

This is a documentation subpage for Template:Infobox currency.
It contains usage information, categories and other content that is not part of the original template page.

Usage

Here is an empty template with some of the most commonly used parameters:

{{ infobox currency
| currency_name_in_local =
| image_1 =
| image_title_1 =
| iso_code =
| issuing_authority =
| issuing_authority_website =
| date_of_introduction = 
| date_of_introduction_source =
| using_countries =
| inflation_rate =
| inflation_source_date = ''[https://www.cia.gov/library/publications/the-world-factbook/fields/2092.html The World Factbook]'', 2010 est.
| subunit_ratio_1 = 1/100
| subunit_name_1 =
| symbol =
| symbol_subunit_1 =
| nickname =
| nickname_subunit_1 =
| plural =
| plural_subunit_1 =
| frequently_used_coins =
| rarely_used_coins =
| frequently_used_banknotes =
| rarely_used_banknotes =
}}

Euro related

{{ infobox currency
| currency_name_in_local =
| image_1 =
| image_title_1 =
| iso_code =
| issuing_authority =
| issuing_authority_website =
| date_of_introduction = 
| date_of_introduction_source =
| using_countries =
| inflation_rate =
| inflation_source_date = ''[https://www.cia.gov/library/publications/the-world-factbook/fields/2092.html The World Factbook]'', 2010 est.
| ERM_since =
| ERM_fixed_rate_since =
| euro_replace_non_cash =
| euro_replace_cash =
| ERM_fixed_rate =
| ERM_band =
| subunit_ratio_1 = 1/100
| subunit_name_1 =
| symbol =
| plural =
| plural_subunit_1 =
| frequently_used_coins =
| rarely_used_coins =
| frequently_used_banknotes =
| rarely_used_banknotes =
}}

Full syntax

{{ infobox currency
| currency_name =
| currency_name_in_local =
| image_1 =
| image_background_1 =
| image_title_1 =
| image_width_1 =
| image_2 = 
| image_background_2 =
| image_title_2 =
| image_width_2 =
| iso_code =
| issuing_authority =
| issuing_authority_title =
| issuing_authority_website =
| date_of_introduction = 
| date_of_introduction_source =
| unofficial_users =
| using_countries =
| 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 =
| superunit_ratio_1 = <!-- thru |superunit_ratio_5 = -->
| superunit_name_1 =
| superunit_inline_note_1 =
| subunit_ratio_1 = <!-- thru |subunit_ratio_5 = -->
| subunit_name_1 =
| subunit_inline_note_1 =
| symbol =
| symbol_subunit_1 = <!-- thru |symbol_subunit_5 = -->
| nickname =
| nickname_subunit_1 = <!-- thru |nickname_subunit_5 = -->
| plural =
| plural_slavic =
| no_plural =
| plural_subunit_1 = <!-- thru |plural_subunit_5 = -->
| used_coins =
| frequently_used_coins =
| rarely_used_coins =
| coin_article =
| used_banknotes =
| frequently_used_banknotes =
| rarely_used_banknotes =
| banknote_article =
| printer =
| printer_website =
| printer_override_with_original_text =
| mint =
| mint_website =
| mint_override_with_original_text =
| obsolete_notice =
| footnotes =
}}

Parameters

This is a complete list of usage. If things get large, use {{Collapsible list}} wisely.

Basic parameters

Attribute	Live currency	Dead currency	Must use with	Default value	Example / Style
currency_name	Optional	Optional		{{PAGENAME}}	To override the very first line in the infobox
currency_name_in_local	Optional	Optional			Suomen markka <small>{{fi icon}}</small><br/> Finska mark <small>{{sv icon}}</small> 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. 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. After all, you wouldn't write "le franc français" in French franc's infobox, right? One line per spelling. Use language icons found at Category:Language icons. If hypothetically Australia, Spain and Portugal all use the Australian dollar, then the infobox would have dólar australiano <small>{{es icon}} {{pt icon}}</small> 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".
image_1	Optional	Optional
image_2	Optional	Optional
image_title_1	Optional	Optional	image_1
image_title_2	Optional	Optional	image_2
image_background_1	Optional	Optional	image_1	(none)	#000000
image_background_2	Optional	Optional	image_2	(none)	#000000
image_width_1	Optional	Optional	image_1	126 / 252	A positive integer, no "px". See East Caribbean dollar, Polish złoty, Slovenian tolar, Chilean peso, Portuguese escudo, Bangladeshi taka, Cypriot pound, Romanian leu, Turkmenistani manat, Luxembourgian franc, and Falkland Islands pound for examples.
image_width_2	Optional	Optional	image_2	126

Usage

Attribute	Live currency	Dead currency	Must use with	Default value	Example / Style
iso_code	Required	Optional			Don't put anything if you can't find it. Not a question mark.
issuing_authority	Optional	Optional			Central Bank of xyz If this exists in the infobox, remove duplicate wiki link from the article's "See also" section
issuing_authority_title	Optional	Optional	issuing_authority	Central bank	Monetary authority, currency board
issuing_authority_website	Optional	Optional	issuing_authority		www.ecb.eu (do not put "http://") and it is recommended that you don't put the trailing / If this exists in the infobox, remove duplicate link from the article's "External link" section
date_of_introduction	Optional	Optional			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	Optional	Optional	date_of_introduction		Name of and reference to the act regarding the introduction of the currency.
using_countries	Required	Required			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

Attribute	Live currency	Dead currency	Must use with	Example / Style
inflation_rate	Optional	Optional		Do not put things like "(2001)" here. Use the next attribute. Don't put anything if you can't find it. Not a question mark.
inflation_source_date	Optional	Optional	inflation_rate	Wikipedia article Sveriges Riksbank, August 2011 The World Factbook, 2010 est. (prefer central bank data over CIA)
inflation_method	Optional	Optional	inflation_rate	CPI, CPI excluding real estate

ERM currencies

Attribute	Live currency	Dead currency	Must use with	Mutually exclusive with	Example / Style
ERM_since	Optional	Optional		pegged_with (unless ERM_withdraw is present)
ERM_withdraw	Optional	Optional	ERM_since		Date (for pound sterling and Italian lira)
ERM_fixed_rate_since	Optional	Optional	ERM_since	pegged_with
euro_replace_non_cash	Optional	Optional	ERM_since	pegged_with	1 January 1999
euro_replace_cash	Optional	Optional	ERM_since	pegged_with	1 January 2002
ERM_fixed_rate	Optional	Optional	ERM_since	pegged_with	"5.94573 mk", not "1 euro = 5.94573 mk". Use symbol if possible.
ERM_band	Optional	Optional	ERM_since	pegged_with	"15%", not "±15%"

Pegging

Attribute	Live currency	Dead currency	Must use with	Mutually exclusive with	Default value	Example / Style
pegged_with	Optional	Optional		ERM_*		euro = 3 units. If the rate is defined that way, do not put the inverse rate like 1 unit = 0.333333 euro.
pegged_by	Optional	Optional				Use ISO 4217 Code if the list gets too long

Subunits

Attribute	Live currency	Dead currency	Must use with	Example / Style
subunit_ratio_{1..5}	Optional	Optional	Preceding subunit_ratio_* Matching subunit_name_(1..5}	1/100, 1/20, 1/240
subunit_name_{1..5}	Optional	Optional	Matching subunit_ratio_{1..5}	Cent (currency), shilling, penny, and do not confuse centavo, centimo, centime, and centesimo. Link the subunit only if there's an article.
subunit_inline_note_{1..5}	Optional	Optional	Matching subunit_name_{1..5}	This is so small that it is not used in practice
superunit_ratio_{1..5}	Optional	Optional
superunit_name_{1..5}	Optional	Optional
superunit_inline_note_{1..5}	Optional	Optional
symbol	Optional	Optional		€, £, $. Link to the articles of the currency symbols if exist (e.g. dollar sign, pound sign)
symbol_subunit_{1..5}	Optional	Optional	Matching subunit_name_(1..5}	¢

Nicknames

Attribute	Live currency	Dead currency	Must use with	Mutually exclusive with	Default value	Example / Style
nickname	Optional	Optional				quid, buck/greenback, loonie/huard
nickname_subunit_{1..5}	Optional	Optional	Matching subunit_name_(1..5}			penny

Plurals

Attribute	Live currency	Dead currency	Must use with	Mutually exclusive with	Example / Style
plural	Optional	Optional		plural_slavic, no_plural	emalangeni (use this is the it doesn't follow English grammar)
plural_slavic	Optional	Optional		plural, plural_subunit_{1..5}, no_plural	Put any non-empty value to enable the Slavic notice. See Russian ruble for example.
no_plural	Optional	Optional		plural, plural_subunit_{1..5}, plural_slavic	Put any non-empty value to enable the no-plural notice. See New Taiwan dollar for example.
plural_subunit_{1..5}	Optional	Optional	Matching subunit_name_(1..5},	plural_slavic, no_plural	aurer (of Iceland)

Frequency (coins)

Attribute	Live currency	Dead currency	Mutually exclusive with	Example / Style
used_coins	Optional	Optional	frequently_used_coins, rarely_used_coins	See below
frequently_used_coins	Optional	Optional	used_coins	See below
rarely_used_coins	Optional	Optional	used_coins	See below
coin_article	Optional	Optional		United States coinage

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 "½ franc", then it's not "50 centimes"
Use ½ and ¼, not 1/2 or 1/4

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 a large numbers, write like these

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

Frequent v.s. 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 small 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 60s) and 20 New Taiwan dollars (a new denomination lacks government support and campaign).

Banknotes that are being replaced by coins (I know this happens all the time, but I just can't think of one that is ongoing right now)
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ónur "rarely used"
Ask yourself this question: When someone buys an electronic that is worth several times of the largest and pays by cash. Is it more 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 have everything to do with the usage in daily life. And the issuance number quoted by the central banks/governments have little meaning in this sense, as a lot of them can be used for interbank transactions, hoarded by tax evaders and drug dealers (I hope this is not "daily life"), by casinos, and in the hands of foreigners.

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 (notes)

Attribute	Live currency	Dead currency	Mutually exclusive with	Example / Style
used_banknotes	Optional	Optional	frequently_used_banknotes, rarely_used_banknotes	See above
frequently_used_banknotes	Optional	Optional	used_banknotes	See above
rarely_used_banknotes	Optional	Optional	used_banknotes	See above
banknote_article	Optional	Optional		Banknotes of the Hong Kong dollar

Production

Attribute	Live currency	Dead currency	Must use with	Example / Style
printer	Optional	Optional		Central Printing Shop Like issuing_authority
printer_website	Optional	Optional	printer	www.komsep.com Like issuing_authority_website, if printer_override_with_original_text is not present
printer_override_with_original_text	Optional	Optional	printer	Put any non-empty value to enable "original text" of printer. For example, [http://www.bportugal.pt/ Banco de Portugal]<br/> [http://www.bankofgreece.gr/ Bank of Greece]]
mint	Optional	Optional		Utopian Mint Like issuing_authority
mint_website	Optional	Optional	mint	www.swissmint.ch Like printer_website
mint_override_with_original_text	Optional	Optional	mint	Like printer_override_with_original_text
obsolete_notice	Optional	Optional		Put any non-empty value to enable the obsolete notice. See German mark for example.
footnotes	Optional	Optional