Placeholders

Placeholders use the syntax {{path.to.data}} and are replaced with actual values when the template is compiled with data. Think of them as variables that get filled with real information each time you send a message.

Prerequisites

Completed Quickstart
Basic understanding of JSON

Basic syntax

Simple variables

Hello {{name}}!

With data:

{ "name": "Sarah" }

Renders as: Hello Sarah!

Object properties

Use dot notation for nested properties:

Email: {{user.email}}
Role: {{user.role}}

With data:

{
  "user": {
    "email": "sarah@company.com",
    "role": "Product Manager"
  }
}

Array elements by index

First item: {{items[0].name}}
Second item: {{items[1].name}}

With data:

{
  "items": [
    { "name": "Widget A" },
    { "name": "Widget B" }
  ]
}

Looping with directives

For dynamic lists, use the #each directive (see Directives):

{{#each items}}
- {{this.name}}: ${{this.price}}
{{/each}}

Inside the loop, this refers to the current item. Use @index for the 0-based index (e.g. Task {{@index + 1}}: {{this.title}}).

Common patterns

User information:

Name: {{user.name}}
Email: {{user.email}}
Manager: {{user.manager.name}}

Order data:

Order #{{order.id}}
Total: ${{order.total}}
Status: {{order.status}}

Dates: Pre-format dates in your data (e.g. "January 15, 2025") and reference them: Created: {{task.created_at}}.

Do calculations and conditional logic before template compilation. Pass ready-to-display values (e.g. status_message: "✅ Approved") and reference them in the template.

Best practices

Use descriptive names: {{user.email}} not {{e}}
Match placeholder paths to your sample data structure
Avoid double dots or typos: {{user..name}} will fail

Next steps

Directives

Generate repeating blocks with #each and conditionals.

Block types

Use placeholders inside blocks.

Getting started

Templates

Interactive

Modals

Advanced

Best practices

Examples

Troubleshooting

Architecture

Prerequisites

Basic syntax

Simple variables

Object properties

Array elements by index

Looping with directives

Common patterns

Best practices

Next steps

Directives

Block types

​Prerequisites

​Basic syntax

​Simple variables

​Object properties

​Array elements by index

​Looping with directives

​Common patterns

​Best practices

​Next steps

Directives

Block types

Prerequisites

Basic syntax

Simple variables

Object properties

Array elements by index

Looping with directives

Common patterns

Best practices

Next steps