Formatter Expansion

The formatter expansion contains various placeholders that allow you to format numbers and text.

Download expansion

/papi ecloud download formatter

Statistics

Fetching data...
If this text doesn't change, check that you allow javascript to be executed.

Source Code

The Source code of this expansion is available on Codeberg

Placeholders

• Number
  • %formatter_number_format[_[locale]:[pattern]]_<number>%
  • %formatter_number_from:<time_unit>_to:<time_unit>_<number>%
  • %formatter_number_round[_[precision]:[rounding_mode]]_<number>%
  • %formatter_number_shorten[_<rounding_mode>]_<number>%
  • %formatter_number_time[_<time_unit>]_<number>%
• Text
  • %formatter_text_capitalize[_<option>]_<text>%
  • %formatter_text_length_<text>%
  • %formatter_text_lowercase_<text>%
  • %formatter_text_replace_[target]_[replacement]_<text>%
  • %formatter_text_substring_[start]:[end]_<text>%
  • %formatter_text_uppercase_<text>%

External Placeholders support

Placeholders from other expansions can be used by using the {<identifier>_<value>} pattern instead of the usual %<identifier>_<value>% pattern.

Using Percent Symbol (%) and Underscores (_) in placeholder

Due to how PlaceholderAPI handles placeholders can you not use the percent symbol in formatter. In addition can underscores also not be used as they can mess up the handling by the expansion.
To still be able to use these characters does the formatter expansion offer two special placeholders named {{prc}} and {{u}} respectively, which get replaced by their respective values.

Warning

You cannot use {{prc}} to use %<identifier>_<value>% placeholders in formatter. The expansion parses bracket-placeholders before converting its own placeholders.

Config Options

See the Config Options page for available config options of this expansion.

Changelog

Please see the CHANGELOG.md file on Codeberg for the latest changes.

---

Last update: 17. March 2026 ()