Bluetick.io uses the Liquid template engine for formatting emails that are sent to your contacts. This allows you to inject information that is specific to your contacts into individual emails.

Technical Notes

Generally speaking, the documentation found at http://dotliquidmarkup.org/ is applicable to how Bluetick operates internally. The Liquid for Designers section is applicable for building your email templates: https://github.com/Shopify/liquid/wiki/Liquid-for-Designers

Bluetick Specific Notes

The following fields are available for use within Bluetick:

Contact Fields

Fields from a contact are accessed using the following syntax:
{{ contact.FieldName }}

Available fields:

  • emailaddress
  • first_name (as of 2016-05-25, firstname is an alias. ie: contact.firstname)
  • last_name (as of 2016-05-25, lastname is an alias. ie: contact.lastname
  • title
  • position (is an alias for title. ie: contact.position and contact.title show the same information)

Company Fields

Fields from a Company the contact is a part of can be accessed using the following syntax:
{{ contact.company.FieldName }}

Available fields:

  • address
  • city
  • country
  • name
  • notes
  • phone
  • state -or- province (these are synonyms)
  • website
  • zip -or- postalcode (these are synonyms)
Example:
{{ contact.company.name }}

Custom Fields

Custom Contact Fields provide you the ability to use any custom field name you wish within a Contact without worrying about conflicting with system-level field names. Custom Contact fields are accessed using the following syntax

{{ contact.cf.CustomFieldName }}

Sender Fields

There are two Sender fields that can be injected into an email:
  • sender.from_email_address
  • sender.signature
Example:

{{ sender.signature }}

Filters

A Filter is a mechanism for converting or translating one piece of data into another. An example of this is using the 'default' transform to set a default value if no data exists.

Default

If you wish to use a default value for a field which may not be set, you can use the following syntax in your email template:
{{ contact.cf.CustomFieldName | default: "Default Value" }}

Example:
Hi {{ contact.cf.fullname | default: "there" }}