Skip to main content

Format

The Format node provides string formatting and transformation operations. Use it to build formatted strings from templates, change case, trim whitespace, pad strings, and perform find-and-replace operations.

Actions​

ActionDescription
format:templateBuild a string from a template with variable substitution
format:toUpperCaseConvert string to upper case
format:toLowerCaseConvert string to lower case
format:trimRemove leading and trailing whitespace
format:padLeftPad a string on the left to a target length
format:padRightPad a string on the right to a target length
format:replaceFind and replace text within a string
format:substringExtract a portion of a string
format:concatConcatenate multiple strings
format:splitSplit a string into an array by a delimiter

format:template​

Builds a string by substituting variables into a template. Supports \{\{variable\}\} syntax.

Parameters

ParameterTypeRequiredDescription
templatestringYesTemplate string with \{\{variable\}\} placeholders
valuesobjectNoAdditional values to make available for substitution

format:toUpperCase / format:toLowerCase​

Converts a string to upper or lower case.

Parameters

ParameterTypeRequiredDescription
inputstringYesString to convert
localestringNoLocale for case conversion (e.g., tr-TR for Turkish)

format:trim​

Removes leading and trailing whitespace (or specified characters).

Parameters

ParameterTypeRequiredDescription
inputstringYesString to trim
charactersstringNoCharacters to trim. Defaults to whitespace
modestringNoboth, left, right. Defaults to both

format:padLeft / format:padRight​

Pads a string to a target length.

Parameters

ParameterTypeRequiredDescription
inputstringYesString to pad
lengthintegerYesTarget length
padCharstringNoCharacter to pad with. Defaults to space

Result: "0000001234"

format:replace​

Performs find-and-replace on a string. Supports regex patterns.

Parameters

ParameterTypeRequiredDescription
inputstringYesInput string
findstringYesText or regex pattern to find
replaceWithstringYesReplacement text
isRegexbooleanNoTreat find as a regex pattern. Defaults to false
replaceAllbooleanNoReplace all occurrences. Defaults to true

format:substring​

Extracts a portion of a string by position.

Parameters

ParameterTypeRequiredDescription
inputstringYesInput string
startintegerYesStart index (zero-based)
endintegerNoEnd index (exclusive). If omitted, extracts to the end

format:concat​

Concatenates multiple strings with an optional separator.

Parameters

ParameterTypeRequiredDescription
valuesarrayYesArray of strings to concatenate
separatorstringNoSeparator between values. Defaults to empty string

format:split​

Splits a string into an array using a delimiter.

Parameters

ParameterTypeRequiredDescription
inputstringYesString to split
delimiterstringYesDelimiter to split on
limitintegerNoMaximum number of splits

Connection​

No connection required. This is a data transformation node.

Output​

For split, the result is an array. For all other actions, the result is a string.