What are advanced merge tags?
While regular merge tags allow you to add personalised data to a message or document template, advanced merge tags allow you to use logic to go one step further.
Use the advanced merge tag icon in message templates and document templates to add variable text based on the following conditions:
![]()
- if the customer's balance is negative (helpful for reminding the customer to make payment, or to feel good about themselves)
- if the customer's balance is positive (helpful for reminding the customer they have credit to use, or that you're all square)
- if the customer is a business (helpful for using the business name for businesses and first name for individuals)
- if the customer has a particular tag (useful if you're using tags to categorise customers. Not to be confused with merge tags)
- if an invoice is overdue (helpful for reminding the customer to make payment, or reassuring them its not due yet)
- or create your own condition based on a merge tag
Add an advanced merge tag
Place the cursor where you want to insert an advanced merge tag.
Tap the advanced merge tag icon in the toolbar.
Select a
Quick condition. SelectOtherto create your own condition.If you've selected
Other, edit theConditionfield. If you've selectedIf customer has tag, you'll need to swap out 'Tag name' with the exact tag name found in the tag library.Edit the
If trueandIf falsefields. The customer will only see the text that is true for them based on the condition selected.
Customising advanced merge tags
Here are the basics to create your own logic:
- ==
- Equals (example:
job.status == 'completed') - !=
- Does not equal (example:
customer.addressTown != 'London')
: Greater than (example: invoice.total > 100)
- <
- Less than (example:
customer.balancePence < 0)
=: Great than or equal to
- <=
- Less than or equal to
- or
- Logical or (requires any part to be true)
- and
- Logical and (requires all parts to be true)
We're using a language called Liquid to make this logic possible. Click here to read the full docs.
Advanced merge tags are powerful but sensitive to typos. Preview your documents or send a test message to yourself to ensure your logic renders exactly how you intended.