This is a documentation subpage for Template:Format price. It may contain usage information, categories and other content that is not part of the original template page.

This template is used on approximately 8,900 pages and changes may be widely noticed. Test changes in the template's /sandbox or /testcases subpages, or in your own user subpage. Consider discussing changes on the talk page before implementing them.

This template displays numbers typically representing prices in a pleasant way, ideally suited for articles. Numbers one thousand or greater are reduced down and rounded to a total of three digits followed by a multiplier text, and smaller numbers receive separators and exactly two digits to represent cents, which does not always happen with the ((formatnum:)) magic word.

((Format price|value|digits))

Where:

• value: the value that will be formatted and displayed (required).
• digits: sets the digit in which a value lower than one thousand must be rounded, defaulting to "2" (cents) if unspecified.

Providing non-numeric parameters, failing to provide any parameter, or providing a negative value parameter, result all in a link to the NaN article. Despite its name, this template only handles the number-formatting, not any unit symbols – consider ((currency)) for that separate feature.

• Y ((Format price|1.2)) = 1.20
• Y ((Format price|456.789)) = 456.79
• Y ((Format price|456.789|1)) = 456.80
• Y ((Format price|456.789|0)) = 457
• Y ((Format price|456.789|-2)) = 500
• Y $((Format price|1234)) = $1,234
• Y $((Format price|12345)) = $12,345
• Y $((Format price|123456)) = $123,456
• Y $((Format price|1000000)) = $1 million
• Y ¥((Format price|98765432109876)) = ¥98.8 trillion
• Y ((Format price|7.86178E+25)) atoms = 78.6 septillion atoms

• N ((Format price)) = Format price error: cannot parse value "" (empty parameter)
• N ((Format price||0)) = Format price error: cannot parse value "" (empty first parameter)
• N ((Format price|-100)) = Format price error: cannot parse value "-100" (negative values are invalid)
• N ((Format price|xyz|A)) = Format price error: cannot parse value "xyz" (only numeric values are allowed)
• N ((Format price|1E+309)) = Format price error: cannot parse value "1E+309" (overflow)

• ((Inflation))
• ((Inflation/fn))
• ((currency))