Conditional Helpers

You can use conditional/logic helpers to insert different content depending on certain conditions.

If/Else

The if/else block helper conditionally renders blocks of content. if and else if statements render content when the condition is true, and else renders content when all previous conditions are false.

Here are some examples of how you can use it.

Insert first name when available

When to.first_name is available, the template will render Hello John. If to.first_name is not available, the template will render Hello there.

Change the template variables to see it works.

Template

Hello {{#if to.first_name}} {{to.first_name}} {{else}} there {{/if}}

Hello
{{#if to.first_name}}
{{to.first_name}}
{{else}}
there
{{/if}}

Variables (JSON)

{"to": {"first_name": "John"}}

{"to": {"first_name": "John"}}

Preview

Hello John

Insert content when people are CC'd

Template

{{#if cc.0.email}} I've CC'd everyone here. {{else}} We don't need to CC anyone. {{/if}}

{{#if cc.0.email}}
I've CC'd everyone here.
{{else}}
We don't need to CC anyone.
{{/if}}

Variables (JSON)

{"cc": [{"email": "john@briskine.com"}]}

{"cc": [{"email": "john@briskine.com"}]}

Preview

I've CC'd everyone here.

Unless

The unless helper is the inverse of the if helper. It will render when the condition is false.

Insert content when people are not CC'd

Rename the to variable in the JSON tab to cc, to see how it renders differently.

Template

Here's the email. {{#unless cc.email}} Forgot to CC anyone. {{/unless}}

Here's the email.
{{#unless cc.email}}
Forgot to CC anyone.
{{/unless}}

Variables (JSON)

{"to": {"email": "john@briskine.com"}}

{"to": {"email": "john@briskine.com"}}

Preview

Here's the email. Forgot to CC anyone.

And/Or

The and/or helpers allow to string together complex conditions for rendering.

You can use the and helper by itself to render the last true value, if all values are true. The or helper, used by itself, will render the first true value, if at least one value is true.

Both of them can be combined with the if helper, as subexpressions, to check for multiple values.

Insert first name if last name is available

Template

{{and to.last_name to.first_name}}

{{and to.last_name to.first_name}}

Variables (JSON)

{"to": {"first_name": "John", "last_name": "Briskine"}}

{"to": {"first_name": "John", "last_name": "Briskine"}}

Preview

John

Insert first or last name if available

Template

{{or to.last_name to.first_name}}

{{or to.last_name to.first_name}}

Variables (JSON)

{"to": {"first_name": "John", "last_name": "Briskine"}}

{"to": {"first_name": "John", "last_name": "Briskine"}}

Preview

Briskine

Insert a default if first name is not available

Template

Hi {{or to.first_name "there"}}

Hi {{or to.first_name "there"}}

Variables (JSON)

{"to": {"first_name": ""}}

{"to": {"first_name": ""}}

Preview

Hi there

Insert full name only if both first name and last name are available

Template

Hello {{#if (and to.first_name to.last_name)}} {{to.first_name}} {{to.last_name}} {{else}} there {{/if}}

Hello
{{#if (and to.first_name to.last_name)}}
{{to.first_name}} {{to.last_name}}
{{else}}
there
{{/if}}

Variables (JSON)

{"to": {"first_name": "John", "last_name": "Briskine"}}

{"to": {"first_name": "John", "last_name": "Briskine"}}

Preview

Hello John Briskine

Equal/Not Equal

The compare helper lets you check if two, or more, values are equal or not. The helper requires at least three parameters: the operator (can be one of ===, ==, !==, !=, <, <=, >, >=), and at least two values. You can also add more values if you want to compare three or more.

Like the and/or helpers, you can combine the compare helper with the if block helper to conditionally render different blocks of content.

Insert different content for a specific email

Template

Hello {{#if (compare "===" to.email "john@briskine.com")}} John from Briskine {{else}} anonymous user {{/if}}

Hello
{{#if (compare "===" to.email "john@briskine.com")}}
John from Briskine
{{else}}
anonymous user
{{/if}}

Variables (JSON)

{"to": {"email": "john@briskine.com"}}

{"to": {"email": "john@briskine.com"}}

Preview

Hello John from Briskine

Check if email is not equal

Template

Is email different from john@briskine.com? {{compare "!==" to.email "john@briskine.com"}}

Is email different from john@briskine.com?
{{compare "!==" to.email "john@briskine.com"}}

Variables (JSON)

{"to": {"email": "mark@briskine.com"}}

{"to": {"email": "mark@briskine.com"}}

Preview

Is email different from john@briskine.com? true

Greater than and Less than

The compare helper can also be used to check if a value is greater, or less, than another, by using the <, <=, >, >=, operators.

Conditional good morning / afternoon / evening

Template

Good {{#if (compare ">" (moment format="HH") 17)}} evening {{else if (compare ">" (moment format="HH") 12)}} afternoon {{else}} morning {{/if}}

Good
{{#if (compare ">" (moment format="HH") 17)}}
evening
{{else if (compare ">" (moment format="HH") 12)}}
afternoon
{{else}}
morning
{{/if}}

Preview

Good afternoon