How to use Liquid in Xink email signatures

Summary

Short answer:
Liquid helps you build advanced email signatures and campaigns in Xink by using logic, conditions, and formatting rules directly in the template.

Use Liquid when you need to:

• Format employee data before it appears in the signature
• Show or hide content based on conditions
• Insert campaigns only for employees who match multiple criteria
• Reduce the need to manually clean or restructure synced data

Liquid is a template language that makes it easier to create signatures and campaigns with complex logic and data formatting.

It supports a wide range of built-in tags, objects, and filters. You can also combine them and nest conditions inside each other. This allows you to create more precise and flexible signatures for each employee without needing to change the original data format in your source system.

Example 1: Format phone numbers and hide blank values

You synced phone numbers from Active Directory into Xink in this format:

+1 9083408836 or +1 9083408836x123

You want the signature to show them like this:

1. 908 340 8836
2. 908 340 8836 x123 if an extension exists
3. No phone number at all if the employee record is blank

Instead of manually updating hundreds or thousands of records, Liquid lets you handle the formatting directly in the template:

{% if DirectPhone == blank %}{% else %}{% if DirectPhone | contains: 'x' %}{{DirectPhone | substr_after: '+1' | phone_format: '000-000-0000 x000'}} (direct)
{% else %}{{DirectPhone | substr_after: '+1' | phone_format: '000-000-0000'}} (direct)
{% endif %}{% endif %}

Example 2: Show a campaign only for a very specific group

Campaign Rules normally allow filtering on up to two fields. Liquid allows you to check several fields at once.

Example requirement:

If Country = Denmark and Office is not A080, A020, or A310, then show a specific campaign.

{% unless Office | contains: 'A080' or Office | contains: 'A020' or Office | contains: 'A310' %}{% if Country | contains: 'Denmark' %}{{ campaign[16041] | raw }}{% endif %}{% endunless %}

How to add Liquid to your signature

1. Open your signature and click Source in the toolbar.
2. Type @liquid at the very top of the source.
3. Paste your Liquid code below it.
4. Click Source again.
5. Preview the result.
6. Click OK.

Use Source to add the Liquid instruction.

@liquid must stay at the top of the signature.

Once @liquid is placed at the top, you can add your Liquid conditions and formatting directly below it in Source.

When you insert fields from the Fields dropdown, they appear with round brackets by default, for example ((Email)).

When using Liquid, replace them manually with curly braces instead:

{{Email}}, {{DisplayName}}, {{JobTitle}}