Articles in this section

split helper

Tom Santiago
Updated

Usage

Use the split helper to break a string into an array of substrings based on a specified delimiter. You can optionally return a single element from the resulting array by providing its 0-based index.

{{split field delimiter [index]}}

  • field: The field or variable containing the string to split (e.g., record.fullName).

  • delimiter: The character(s) used to split the string (e.g., "-", ",", " ").

  • index (optional): Zero-based index indicating which substring to return. If omitted, the helper returns the substring at index 0.

Examples

  1. Getting specific parts of a name

    If record.fullName is "Hillary-Ann-Swank", then:

    {{split record.fullName "-" 0}}  →  Hillary
{{split record.fullName "-" 1}}  →  Ann
{{split record.fullName "-" 2}}  →  Swank

  2. Returning substring at position 0 (no index)

    {{split record.fullName "-"}}

    Produces substring at index position 0 (e.g., "Hillary").

Tip

  • If the delimiter does not appear in the string, the helper returns the string itself (or an empty result if the string is empty).

  • Double-check that the delimiter matches exactly what you expect (e.g., a space vs. a hyphen).

  • Use triple braces ({{{ }}}) if you prefer raw, unformatted output of the resulting comma-separated list.