The join helper concatenates two or more values with a specified delimiter between each item. Use it to build paths, construct delimited strings, or combine multiple field values into a single output.
Syntax
{{join delimiterField field1 field2...}}
delimiterField -- The string to place between each value (e.g. "-", "/", ","). Required.
field1, field2,... -- Two or more values or field references to join. Each must be a string or convertible to a string.
Examples
Join literal strings
{{join "-" "unicorn" "ponies"}}
Output: unicorn-ponies
Join record fields with a comma
{{join "," record.band1 record.band2 record.band3}}
Input: record.band1 is "Iron Maiden", record.band2 is "DIO", record.band3 is "(old)Metallica"
Output: Iron Maiden,DIO,(old)Metallica
Build a file path from field values
{{join "/" record.folder record.subfolder record.filename}}
Input: record.folder is "root", record.subfolder is "images", record.filename is "logo.png"
Output: root/images/logo.png
Usage notes
- You can pass any number of items after the delimiter.
- If any item is an array, each element of the array is joined using the specified delimiter.
- All items must be strings or convertible to strings. Non-string, non-array values may produce unexpected output.