Merge Tags Syntax

Example

JSON

{{#subrecord-table}} {{#orderBy [type].[name] [--string] asc}}

📌 3. Conditional Tags

Conditional tags let you display content only when conditions are met.

JSON

{{conditional #if (eval conditional_field '=' true)}} 

Texts inside this block will be rendered if the condition is met...

{{/if}}

Key Points

• conditional_field can be any field from the parent record or a nested select field.

• You can also use nested fields, like select fields. For example:

JSON

{{conditional #if (eval organisation.location '=' 'Australia')}}

• Complex conditions with multiple criteria are not supported. For example:

JSON

{{conditional #if (eval field_1 '=' true' && field_2 '!=' false)}}

🔘 4. Multi Select Tags

Use multi-select tags to list values from multi-choice fields.

JSON

{{multiSelect #each [multi-select-field]}}{{[fieldname]}}{{#unless @last}},{{/unless}}{{/each}}

Key Points

• The multi-select-field can be any of the multi-choice fields in the system (Checkbox, radio, multi-select) of the parent record (for which we are generating the merged docx)

• The fieldname refers to the field of the multi-choice record.

🚧Warning

Ensure the spacing in the code snippet is exactly as shown above. Incorrect spacing can cause parsing issues with the Handlebars compiler.

Example

To display all the names from the multi-select field types-of-variation, use:

JSON

{{multiSelect #each [types-of-variation]}}{{[name]}}{{#unless @last}},{{/unless}}{{/each}}

Variation

If you prefer each multi-select value to appear on a new line rather than inline, use the "-newline" tag:

JSON

{{multiSelect-newline #each [types-of-variation]}}{{[name]}}{{#unless @last}},{{/unless}}{{/each}}

Notes

1. Do not use the multiSelect keyword. Instead, use the following syntax:

Bash

{{#each [types-of-variation]}}{{[name]}}{{#unless @last}},{{/unless}}{{/each}}

2. Multi-select tags do not support rich text fields or any fields enclosed in triple curly braces ({{{ }}}). For example:

JSON

{{multiSelect #each [multi-select-field]}}{{{[rich-text]}}}{{#unless @last}},{{/unless}}{{/each}}

🔡 5. Rich Text Tags

JSON

Rich text:

{{{[rich-text-field]}}}

Key Points

1. Always use triple curly braces {{{ }}}.

2. Rich text tags do not work inside multi-select tags.

3. Place the rich text tag on its line. This is important because the merging process replaces the entire line with the formatted rich text. Avoid combining it with other text on the same line, like this:

JSON

The Rich text: {{{[rich-text-field]}}} is now formatted!

4. Rich text tags don't work correctly inside regular tables. To display rich text within a regular table (not association or sub-record), use the tableRichText tag instead. This will render the rich text as raw text within the table.

JSON

{{{tableRichText [rich-text-field]}}}

Example of Using tableRichText in a DOCX Document

📅 6. Moment Date Tag

JSON

{{formatDate [auth-reconc-posted] 'dddd D MMMM YYYY h:mm:ss' [__timezone]}}

{{formatDate [auth-reconc-posted] 'dddd D MMMM YYYY h:mm:ss'}}

// for formatting current date

{{formatCurrentDate 'dddd D MMMM YYYY h:mm:ss' [__timezone]}}

{{formatCurrentDate 'dddd D MMMM YYYY h:mm:ss'}}

Key Points

1. The syntax matches what is used in the Unlayer tool within our system's email/PDF builder.

2. Ensure the date format is enclosed in single quotes ' ', not the apostrophe symbol used by Google Docs.

3. The formatCurrentDate tag formats the current Australian date and time according to the provided format.

Notes

When using date tags within association or sub-record tables, use the specific syntax:

JSON

{{formatCurrency [currency-field]}}

Key Points

This tag automatically attaches a dollar sign, adds a thousand separator, and displays two decimal places.

• 1000 converts to $1,000.00

• 9000.5 converts to $9,000.50

Notes

When using currency tags within association or sub-record tables, use the following syntax: