Templates

Why are the template fields not pulling any information into the document or email I've created?

Pay special attention to the "types" of fields you are plugging into your templates.

"Job.Primary Contact" template fields:

Choosing a field from the Job.Primary Contact options will pull the selected details from the primary contact record of the job under which the document is being created. 

Example: I have a job called "job test" whose primary contact is "Jane Tester". 

Screenshot 2023-11-28 at 2.25.36 PM

I have a document to create under the Job using a template that includes the field {{JobPrimaryContactDisplayName}} . 

doc temp job primary field

 

Upon creating this document for the Job, the display name Jane Tester will populate where the field has been added, since that is the name of this primary contact.

doc temp primary contact document

"Job" and "Contact" template fields:

As the name of the field suggests, choosing a field from either the job or contact options will populate information specific to that contact or job. 

Example: I have a contact called "Jo Tester" whose display name I would like to populate when creating my document. 

I have a document to create under the Contact using a template that includes the field {{ContactDisplayName}} .

doc temps contact type temp field

Upon creating this document for the Contact, the display name Jo Tester will populate where the field has been added since that is the name of this contact. 

contact temp field display name

Takeaway:

  1. Contact-specific template fields will only populate information if the document is being created under a contact
  2. Job-specific template fields will only populate information if the document is being created under a job.
  3. Job.Primary Contact-specific template fields will only populate information if the document is being created under a job with an associated primary contact.

 

"Task" and "Activity" template fields:

These two types of template fields can only be used in email templates that are sent out by an automation triggered by either a task or recorded activity.

Example 1: I want an event-based automation to send an email out that contains details of a task that has been created. The email template I use for the automation will include the task's start date.

task specific temp field email temp

 

With the task creation being the automation's "triggering event", the email that is sent out will contain the triggering task's start date, as anticipated. Under the Activity tab of the task, you can see the body of the outbound email as well as the event that triggered the automation.

task specific temp field sent email

 

Example 2: I want an event-based automation to send an email out when a certain type of activity has been created under a contact or job's record.

activity template

 

The email template I use will contain the name of the user who created the activity, as well as the date the activity was created.

email temp for activity

 

When I add a note to a customer's record, I'll select the type I specified as the automation's condition in order for the email to send out.

note type activity automation

Under the Activity tab of the record under which I added the note that met the conditions of my previously created automation, I now see an outbound email that contains the contents of the activity-specific template fields used.

activity log

 

"Work Order" template fields:

Much like tasks and activity, work order-specific fields can only pull information if a work order triggers an automated email.

Example: I want a team member to receive an automated email containing details of their assigned work order once it has been created. The email template I use for the automation will include the work order's start date.

The email template I use will contain the name of the user who is assigned to the work order as well as the work order's start date.

This is the only way work order details can be plugged into a template using short codes. Document templates are not compatible with work order template fields.