All Collections
Basic Setup
Using Message Templates
Variables Used in Message Templates
Variables Used in Message Templates

Know the variables that can be inserted within the body of the message templates to act as placeholders for the actual values in real-time

Updated over a week ago

The variables are divided into the following categories based on their context:

GLOBAL VARIABLES

1 Variables to Display your Company Details

These may be used in any message template

  • Name:{{businessUnit.companyName}}

  • Number: {{businessUnit.companyNumber}}

  • Email: {{businessUnit.email}}

  • Phone: {{businessUnit.telephoneWork}}

  • Fax: {{businessUnit.fax}}

  • Website: {{businessUnit.website}}

  • Postal address: {{businessUnit.postalAddress.formattedAddress}}

  • Billing / Street address: {{businessUnit.streetAddress.formattedAddress}}

2 Generic Contact Variables

Any contact variable such as Recipient, Customer, Owner, Requestor, Alternate Contact, Site Contact (specified below with an asterisk i.e. * ) may be appended with these generic variables in order to include the respective field.

  • Full name: displayName

  • First name: firstName

  • Last name: lastName

  • Email:email

  • Phone: telephoneWork

For example, {{recipient.displayName}} or {{customer.firstName}} and so on.

3 Message Recipient

This may be used in any message template, however the variable will only be populated where the recipient already exists in Loc8 as a customer, customer contact or user.

  • Recipient *: {{recipient.CONTACT-VARIABLE}}

Where CONTACT-VARIABLE will be replaced by one of the generic contact variables discussed in section 2 Generic contact variables.

JOB VARIABLES

These variables are only available in the Job Message Templates category, and will only be populated when the template is used in automation rules triggered by a Job, Appointment or Assignee/Technician event.

 1 Basic

  • Customer *: {{workOrder.customer.CONTACT-VARIABLE}}

  • ID: {{workOrder.workOrderNumber}}

  • Reference: {{workOrder.reference}}

  • Lifecycle: {{workOrder.status}}

  • Status: {{workOrder.subStatus}}

  • Type: {{workOrder.type}}

  • Priority: {{workOrder.priority}}

  • Subject: {{workOrder.subject}}

  • Start by: {{workOrder.latestStart}}

  • Due by: {{workOrder.dueDate}}

  • Owner *: {{workOrder.owner.CONTACT-VARIABLE}}

  • Requestor *: {{workOrder.requestor.CONTACT-VARIABLE}}

  • Alternate contact *: {{workOrder.siteContact.CONTACT-VARIABLE}}

 2 Location (if saved as a Site)

  • Address: {{workOrder.site.address.formattedAddress}}

  • Site name: {{workOrder.site.name}}

  • Site ID: {{workOrder.siteId}}

  • Site contact *: {{workOrder.site.siteContact.CONTACT-VARIABLE}}

3 Appointment

  • Scheduled start time: {{workOrder.activeAppointment.start}}

  • Scheduled end time: {{workOrder.activeAppointment.end}}

4 Meta

  • Created: {{workOrder.createdDate}}

  • Updated: {{workOrder.lastUpdated}}

  • Web view URL: {{#workOrder.htmlLink}}Link text{{/workOrder.htmlLink}}

5 Financials

  • Total excluding tax: {{workOrder.totalExcludingTax}}

  • Total tax: {{workOrder.totalTax}}

  • Total including tax: {{workOrder.totalIncludingTax}}

QUOTE VARIABLES

These variables are only available in the Quote Message Templates category, and will only be populated when the template is used in automation rules triggered by a Quote event.

1 Basic

  • Customer *: {{quote.customer.CONTACT-VARIABLE}}

  • ID:  {{quote.quoteNumber}}

  • Status: {{quote.subStatus}}

  • Subject: {{quote.subject}}

  • Owner *: {{quote.owner.CONTACT-VARIABLE}}

  • Requestor *: {{quote.requestor.CONTACT-VARIABLE}}

  • Alternate contact *: {{quote.siteContact.CONTACT-VARIABLE}}

 2 Location (if saved as a Site)

  • Address: {{quote.site.address.formattedAddress}}

  • Site name: {{quote.site.name}}

  • Site ID: {{quote.siteId}}

  • Site contact *: {{quote.site.siteContact.CONTACT-VARIABLE}}

3 Meta

  • Created: {{quote.createdDate}}

  • Updated: {{quote.lastUpdated}}

  • Web view URL: {{#quote.htmlLink}}Link text{{/quote.htmlLink}}

4 Financials

  • Total excluding tax: {{quote.totalExcludingTax}}

  • Total tax: {{quote.totalTax}}

  • Total including tax: {{quote.totalIncludingTax}}

INVOICE VARIABLES

These variables are only available in the Invoice Message Templates category, and will only be populated when the template is used in automation rules triggered by an Invoice event.

1 Basic

  • Customer *: {{invoice.customer.CONTACT-VARIABLE}}

  • ID: {{invoice.invoiceNumber}}

  • Status: {{invoice.status}}

  • Total charge: {{invoice.totalCharge}}

2 Meta

  • Created: {{invoice.createdDate}}

  • Updated: {{invoice.lastUpdated}}

  • Web view URL: {{#quote.htmlLink}}Link text{{/quote.htmlLink}}

3 Financials

  • Total excluding tax: {{invoice.totalExcludingTax}}

  • Total tax: {{invoice.totalTax}}

  • Total including tax: {{invoice.totalIncludingTax}}

ASSET VARIABLES

These variables are only available in the Asset Message Templates category, and will only be populated when the template is used in automation rules triggered by an Asset event.

1 Basic

  • Customer *: {{asset.customer.CONTACT-VARIABLE}}

  • ID: {{asset.assetId}}

  • Status: {{asset.status}}

  • Type: {{asset.assetClass.name}}

  • Serial: {{asset.serialNumber}}

  • Condition: {{asset.condition}}

  • Statutory maintenance: {{asset.statutoryMaintenance}}

  • Critical infrastructure: {{asset.criticalInfrastructure}}

  • Current value: {{asset.currentValue}}

  • Replacement value: {{asset.replacementValue}}

  • Purchase date: {{asset.purchaseDate}}

  • Purchase cost: {{asset.purchaseCost}}

  • Warranty end date: {{asset.warrantyEndDate}}

  • Owner *: {{asset.owner.CONTACT-VARIABLE}}

  • Maintainer *: {{asset.defaultMaintainer.CONTACT-VARIABLE}}

 2 Location (if nested under a Site)

  • Address: {{asset.site.address.formattedAddress}}

  • Site name: {{asset.site.name}}

  • Site ID: {{asset.site.assetId}}

  • Site contact *: {{asset.site.siteContact.CONTACT-VARIABLE}}

3 Meta

  • Created: {{asset.created}}

Did this answer your question?