Formatters

When using a variable inside a text field, you can alter how that variable is processed and used (e.g., in file paths, log messages, or API data) by appending a pipe (|) and then the formatter name or symbol.

---

💡 Quick Examples & Usage

To apply a formatter, use the syntax:

{variable.Name|formatter}

Formatters can be chained together, with the order they appear being the order they are applied:

{file.Name|nospaces|upper}

Example Usage:

If file.Size is the numerical value for 32,780,000,000 bytes and file.Create is 2022-10-29 11:41:00.

The template: {file.Name!} - {file.Size|size} {file.Create|dd-MM-yyyy} {file.Create|time}

Produces: FILENAME.EXT - 32.78 GB 29-10-2022 11:41

Hint: You can even use a formatter on a literal value you type in, for example {645645654|size} produces 645.65 MB.

---

Variable Formatter Reference

🔡 Case and Text Formatters

These formatters adjust the case or general structure of text.

Formatter	Name	Description	Example Input	Example Output
name	Name Case	Converts a value to proper name case. Handles common prefixes like Mc, Mac, O', and hyphenated names.	john mcsmith o'brien	John McSmith O'Brien
!	Upper Case	Converts the value entirely to UPPERCASE.	myvalue	MYVALUE
upper	Upper Case	(Alias for !) Converts the value entirely to UPPERCASE.	myvalue	MYVALUE
lower	Lower Case	Converts the value entirely to lowercase.	MYVALUE	myvalue
nospaces	No Spaces	Removes all spaces from the value.	My Value	MyValue

---

📅 Time and Date Formatters

These formatters are used for date and time values.

Formatter	Name	Description	Example Input (Format)	Example Output
date	Date	Formats the value as a standard date (e.g., based on system culture).	Value	11/17/2025
time	Time	Formats the value as a standard time (e.g., based on system culture).	Value	7:58 AM
datetime	DateTime	Formats the value as a standard date and time.	Value	11/17/2025 7:58 AM
Custom Format	DateTime	Use custom C# date and time format strings (e.g., d, M, h, m, s) for specific output.	dd-MM-yyyy h:mm:ss tt	17-11-2025 7:58:32 AM

---

🔢 Numeric and File Formatters

These formatters are for numbers, file sizes, and file path manipulation.

Formatter	Name	Description	Example Input	Example Output
count	Count	Returns the length (number of characters) of the value.	FileName	8
0	Digits Padding	Pads a number with leading zeros. Specify the total desired length, e.g., :0004.	2 with :0004	0002
size	File Size	Formats a numeric value (bytes) into human-readable units (B, KB, MB, GB, TB).	1500000000	1.4 GB
file	Safe Filename	Converts the value into a safe filename by removing or replacing unsafe characters.	my/file:name?	my-file-name