Handlebars Helpers

SuprSend template editor uses handlebars templating language to add variables and support conditional content rendering in a template. You can find the list of inbuilt handlebars helpers here.

Apart from the inbuilt helper functions, we have also created some custom helper functions which you can use in template editors.

​

default

Can be used to add a default value if the variable values are " " , null , undefined.

{{default variable "default_value" }}

Returns:

• Variable value if the variable value is present. For instance, the above example with data {"name":"Joe"} will return Joe
• Default value if variable value is in " " , null , undefined. For instance, the above example with data {"name":""}, {"name":null} or {"city":"Bangalore"} will return user

​

compare

Can be used to show some content in the template based on a condition. For email, you can use display condition to show or hide a particular content block

{{#compare name '==' "Mike"}}
true_block
{{else}}
false_block
{{/compare}}

Returns:

• Returns if the condition inside compare statement returns truthy value. For instance, the above example with data{"candidate_count":1}will returnis
• Returns (in case else statement is present) if the condition inside compare statement returns falsy value. For instance, Example-1 with data{"candidate_count":3}will returnare
• or Returns if the else statement is not present. For instance, Example-2 with data{"candidate_count":3}will not return anything

Supported Conditional operators in compare statement:

However, you can use the nested if condition to check if the parent is present and if so, then render nested objects value. Refer below example:

{{#if place}}
  {{default place.city "San Francisco"}}
{{else}}
  San Francisco
{{/if}}

{{#if person.address}}
  {{#if person.address.current}}
    {{{default person.address.current.city "Los Angeles"}}
  {{/if}}
{{/if}}

​

each

You can iterate over a static or dynamic length list using each helper. Inside the block, you add the array object key which you want to iterate over.

{{#each array_object}}
{{variable_key}}
{{/each}}

Returns: Above example for below mock data will return steve Olivia

​

datetime-format

Returns a formatted date string. This helper will throw error if an invalid date is provided.

{{datetime-format variable "format string" "timezone"}}

Examples:

​

jsonStringify

Coverts any type of JSON input to a string. Can be used to print JSON and array directly in templates without having to convert it into individual strings. One of the common usecase is to pass complete JSON in Inbox template -> custom JSON field to generate custom UI.

{{jsonStringify variable}}

Examples:

​

lowercase

This handlebar helper is used to convert string to lowercase. If non string values are provided empty string '' is returned.

{{lowercase "string"}}

​

uppercase

This handlebar helper is used to convert string to uppercase. If non string values are provided empty string '' is returned.

{{uppercase "string"}}

​

capitalize

This handlebar helper is used to capitalize the first character in provided string. If non string values are provided empty string '' is returned.

{{capitalize "string"}}

​

Math Operators:

​

add

Returns the sum of two operands. Both input values should be numbers, else it will throw an error.

{{add number1 number2}}

Examples:

​

subtract

Returns the difference between two operands. Both input values should be numbers, else it will throw an error.

{{subtract number1 number2}}

Examples:

​

multiply

Returns the product of two operands. Both input values should be numbers, else it will throw an error.

{{multiply number1 number2}}

Examples:

​

divide

Returns the quotient of the left operand divided by the right operand. Both input values should be numbers; else it will throw an error.

{{divide dividend divisor}}

Examples:

​

round

Returns the value of a number rounded to the nearest integer. The input value should be a number; else it will throw an error.

{{round number}}

Examples:

​

mod

Returns the remainder left over when one operand is divided by a second operand. It always takes the sign of the dividend. This helper will throw an error if it encounters an input value that is not a number or if the divisor is 0.

{{mod dividend divisor}}

Examples:

​

Array Operators

​

unique

Returns unique items in an array.

{{unique variable "key_string" }}

Examples:

​

itemAt

Returns item at a particular index in the array. It can be useful in scenarios where you want to display a message like liked by Mike and 3 others.

{{itemAt variable index }}

Examples:

​

join

Concatenates all the values in an array, using a specified separator string between each value.

{{join variable "separator"}}

Examples:

​

length

Can be used to get the number of items in an array or the character length of a string. It can be useful in scenarios where you want to display a message like your post has got 100 likes.

{{length variable}}

Examples: