DataJedi TS — Option Caption Template Guide

This is the definitive guide to building Option Captions in the DataJedi TS plugin. It documents the templating grammar, how values are resolved from your Things (Bubble entries), how filters work (text, numbers, dates, etc.), and every detail needed to get predictable results.

Example (drop this in Option caption):

${display | trim | title} — ${number | num('$0,0.00')} — ${example | date('ddd, m/dd/yy, h:MM TT')}

1) What is an “Option Caption”?

• When your Search List is mapped to Tom Select options, each option starts with:
  • id: the identifier (from your chosen id field)
  • text: the label (from your chosen label field)
• If Option caption is non-empty, it replaces the text label by rendering your template per option.

2) Template syntax

2.1 Basic form

• Write plain text, and insert dynamic expressions using ${ ... }.
• Inside ${ ... }, you reference a field and optionally append filters with pipes |.

Example

${display | upper}

2.2 Fields and nested fields

• Simple field: ${display}
• Nested / dotted path: ${creator.name} traverses creator → name.
• Quoted field names: If your field name contains spaces or special chars, quote it:
  • ${'Created Date' | date('yyyy-mm-dd')}
• If any step in a dotted path is null/empty, resolution stops and returns '' (empty string).

2.3 Escaping ${...} and |