Articles in this section

join helper

Tom Santiago
Updated

Use {{join}} to concatenate multiple fields or literal strings with a chosen delimiter between each item. You can supply any number of items to join.

Usage

{{join delimiterField field1 field2 ...}}

  • delimiterField: The delimiter to place between each value (e.g., "-", "/", ",").

  • field1, field2, ...: One or more values or references to join.

Examples

  1. Joining literal strings 

    {{join "-" "unicorn" "ponies"}}

    Produces "unicorn-ponies".

  2. Combining record fields with a comma 

    {{join "," record.band1 record.band2 record.band3}}

    If record.band1 is "Iron Maiden", record.band2 is "DIO", and record.band3 is "(old)Metallica", the result is "Iron Maiden,DIO,(old)Metallica".

  3. Using a different delimiter 

    {{join "/" record.folder record.subfolder record.filename}}

    For record.folder = "root", record.subfolder = "images", and record.filename = "logo.png", you get "root/images/logo.png".

Tip

  • You can pass in as many items as needed after specifying the delimiter.

  • If any of the items are arrays, each element will be joined using the specified delimiter.

  • Make sure your fields resolve to strings or can be converted to strings; otherwise, you may see unexpected results.