TracCloud: Twig
From Redrock Wiki
(Redirected from TracCloud: Twig)
Many text fields throughout TracCloud support Twig and HTML, giving you greater control in determining what data is displayed to your students, staff, and faculty based on the context of appointments, visits, and more, as well as formatting that data to be as clear as possible.
Twig will be the primary focus of this article. Twig is a template engine that serves two primary purposes in TracCloud:
- 1. Print variables in text
- Personalize your emails and messages. Greet the student by name, let them know what subject they selected in their appointment, what time their appointment takes place, the location, and more. These same variables are also used for purpose #2.
- Personalize your emails and messages. Greet the student by name, let them know what subject they selected in their appointment, what time their appointment takes place, the location, and more. These same variables are also used for purpose #2.
- 2. Add logic to your text
- Modify the email or message based on why it was sent. Add an extra paragraph if Reason X was selected, send a follow-up email after a visit if the student chose Y, prevent an email from being sent on a SAGE referral if Z recommendation was checked, and much more. Rather than creating a generic email for any context, create a dynamic email that changes to match your needs.
- Modify the email or message based on why it was sent. Add an extra paragraph if Reason X was selected, send a follow-up email after a visit if the student chose Y, prevent an email from being sent on a SAGE referral if Z recommendation was checked, and much more. Rather than creating a generic email for any context, create a dynamic email that changes to match your needs.
Twig (and HTML) are supported in profile emails, welcome messages, email templates, appointment display, and more. Most of the examples listed in this article are for appointment emails or SAGE referrals, but the same concepts apply in all other supported fields. It's also worth keeping in mind that Twig exists outside of TracCloud, and there are many resources online for how you can utilize it that will also work here (such as Symfony). This guide likely covers everything you will need, but it doesn't cover everything that Twig is capable of.
HTML will also be used sparingly throughout this article, but without much explanation as it's more ubiquitous than Twig. There are many excellent resources online explaining how to use this markup language, such as W3Schools. HTML is used to adjust font sizes and colors, embed images and videos, and more.
Part 1. Syntax, Terminology, and Essential Knowledge
When reading the wiki or talking to support, you will often see fields like Student.First_Name or Courses.Subject referred to as "Twig tags." To use another term, these are variables. They contain data, it's up to you what you do with that data through Twig. If you're at all familiar with any programming languages, then you likely already know the concepts. This article will provide you with the necessary knowledge to use Twig in TracCloud, regardless of your current knowledge level.
Important: A complete list of Twig tags can be found here. Not all tags can be used in all places, but you can almost always predict what will and won't work in a given location. For example, in the Appointment Confirmation Email, you can expect to use Student, Reason, Subject, Staff tags, etc. Whereas in the Notices on KIOSK, you can only use Center tags. This is because when that message is displayed at the top of an idle kiosk, nothing ties that message to any one Student or Staff record, let alone Registrations, Reasons, etc.
Whenever you're using Twig, you'll see different delimiters being used.
- {{ something }} - You would use this to display (i.e., print or echo) the contents of "something."
- {% something %} - You would use this to execute something, typically to create conditions (e.g., if statements).
- {# something #} - This is a comment. Whatever you write between the hashes will not be displayed. These are handy to make notes for yourself or other admins inside emails and messages.
Here's how those would work in practice. If we sent this to a student named "John," they would receive the message on the right. Notice how the conditional text was handled, and that the comment wasn't shown.
Hi {{Student.First_Name}}!
{% if Student.First_Name == 'Jane' %}
Your name is Jane.
{% else %}
Your name is not Jane.
{% endif %}
{# I never said this example would be realistic #}
Hi John!
Your name is not Jane.
Now here's a more realistic example.
Hi {{Student.First_Name}},
Your appointment has been scheduled for {{Appointment.StartTime}} on {{Appointment.Day}}, {{Appointment.StartDate}} with {{Consultant.FirstLast}}.
{% if Appointment.Online == 1 %}
Click here to join your appointment: {{Appointment.OnlineLink}}.
{% endif %}
Hi John,
Your appointment has been scheduled for 04:00pm on Thursday, 04/02/26 with Dave Smith.
Part 2. if Statements
The vast majority of the logic you're likely to build with Twig will be if statements. Simply, "if A, do X." You could also do "if A, do X. Otherwise if B, do Y. Otherwise if C, [...]" and so on. For a realistic example, "if the student selected the reason 'Exam Help,' then include the following paragraph" or "if the appointment is online, include the online meeting link."
An if statement always begins with {% if [...] %} and ends with {% endif %}. When building emails and messages, you will be working with Twig tags (variables) in these statements. So the following...
{% if 2 > 1 %}
two is greater than one!
{% endif %}
{% if 1 == 1 %}
1 is the same as 1!
{% endif %}
{% if "foo" != "bar" %}
"foo" is a different word than "bar"!
{% endif %}
...functions just like this. Once again, a list of these tags and definitions are available here.
{% if Appointment.Online == 1 %}
This is an online appointment, click the following to join....
{% endif %}
{% if Reason.ReasonName == "Writing Support" %}
Please remember to upload your paper to your appointment. Here's how...
{% endif %}
You can add else and elseif statements before the endif too, to handle alternate cases easily (rather than multiple separate if...endif statements for every condition).
{% if Appointment.Online == 1 %}
Join Virtually: {{Appointment.OnlineLink}}
{% elseif Appointment.Online == 2 %}
Accessing your Appointment: Login to TracCloud to view your asynchronous appointment.
{% elseif Appointment.Online == 3 %}
We will call for your phone appointment at your chosen time.
{% else %}
In-person location: {{Appointment.Location}}
{% else %}
To check multiple conditions, and and or statements can be used.
{% if Reason.ReasonName == "Academic Coaching" and Student.WatchLists.wl_14 == 'true' %}
Please remember to bring XYZ to this appointment.
{% endif %}
{% if Reason.ReasonName == "Peer Tutoring" or Consultant.CustomData.cf_123 == 'true' %}
You have booked an appointment with a Peer Tutor!
{% endif %}
A list of operators can be found in part 4.
Part 3. Working with Arrays
>95% of Twig tags you will work with in TracCloud contain single values, but a very small number of fields are arrays containing multiple values. Most notably, SAGE reasons & recommendations and Multiple Checkbox custom fields.
As an example, take Student.First_Name. This field can only contain one value at any given time. Student.First_Name = Jane, so {{Student.First_Name}} outputs Jane. But how about the Reasons field in SAGE referrals? This is an array that contains "Poor Grades" and "Acceptable Attendance" and "Lack of Focus." If we try to use {{Reasons}}, we'll get an error. That's where we have to take a slightly different approach, using the for tag.
Here's how this works, with an example variable so you can see what it's working with. For each item in the "exampleField" array, it prints the item (and adds a <br> tag to insert a line break).
{% set exampleField = ['a','b','c'] %}
{% for item in exampleField %}
{{item}}<br>
{% endfor %}
a
b
c
Now back to our SAGE example. Remember, Reasons is an array that contains ['Poor Grades','Acceptable Attendance','Lack of Focus'].
{% for item in Reasons %}
{{item}}<br>
{% endfor %}
Poor Grades
Acceptable Attendance
Lack of Focus
You can also check if a value is in an array as an if statement like this. Inversely, you can do not in instead of in to check if a value is not in an array.
{% if 'Poor Grades' in Reasons %}
Here are some great resources to improve your study habits...
{% endif %}
{% if "Meet with Advisor" in Recommendations %}
We recommended that you meet with your advisor, here's how to schedule...
{% endif %}
More Twig examples and tag definitions for SAGE emails can be found here.
Part 4. Tips and Tricks
The remainder of this article covers some extra tips and tricks, as well as unique functions that may be of use.
4.1. Special Tags
TracCloud has a few special functions listed below that can be used to prevent an email from sending, CC additional recipients, automatically get special values, and more. More of these functions are available specifically for certain modules, such as SAGE Early Alerts, Success Plans, and Work Plans. Visit the emails/Twig sections of those articles to learn more. The ones listed below are available throughout TracCloud.
| {{CalcMissedAppointments(Student.Sequence, Center.ProfileID)}} | The student's total number of missed appointments since the date specified in your profile Scheduling Prefs. Uses System Pref date if Profile date is blank. |
| {{CalcMissedDate(Center.ProfileID)}} | Your profile “Calc Missed Appointments Since” date. If this field is blank, this will use your global Calc Missed date instead. |
| {{setAdditionalCC('address@domain.edu,address2@domain.edu')}} | CC additional email addresses, can be used with 'if' statements to make the CC conditional. |
| {{ GetActiveTermFrom() }} | Can be used to get the start date of your current active term(s). |
| {{ GetActiveTermTo() }} | Can be used to get the end date of your current active term(s). |
| {{ setResultActions('SendEmail', '0') }} | Can be used to prevent an email from sending, similar to "#ACTION:DO NOT SEND#" in SAGE emails. |
| {{ GetDatePlusDays(5) }} | Get the current date plus the number of days specified in parentheses |
| {{ GetDateTimePlusDays(5) }} | Get the current date AND time plus the number of days specified in parentheses |
4.2. List of Operators
Beyond the basics like == (equals) and != (not equals), there are plenty more operators available depending on what you want to accomplish.
| Operator | Description | True Example |
|---|---|---|
| == | Equals | {% if 1 == 1 %} |
| != | Does not equal | {% if 'a' != 'b' %} |
| > | Greater than | {% if 2 > 1 %} |
| < | Less than | {% if 1 < 2 %} |
| in | Is contained by (for arrays) | {% if 'a' in ['a','b','c'] %} |
| not in | Is not contained by (for arrays) | {% if 'z' not in ['a','b','c'] %} |
| starts with | Begins with | {% if 'abc' starts with 'a' %} |
| ends with | Concludes with | {% if 'abc' ends with 'c' %} |
4.3. Filters
Filters can be used to modify or change the data stored in variables. One of the most common examples is using the 'date' filter to modify the format of dates in emails. For example, {{Appointment.StartDT}} would return 2026-01-31 14:00:00, while {{Appointment.StartDT|date("D, F j, h:ia")}} would return "Sat, January 31, 02:00pm." (click here for a list of datetime format codes). A list of some of the supported filters and functions in TracCloud can be found below.
| Filter | Description | Example | Output |
|---|---|---|---|
| date | Change the format of a date field | {{Appointment.StartDT|date("Y-m-d")}} | 2026-01-31 |
| lower | Changes contents to lowercase | {{Student.First_Name|lower}} | jane |
| upper | Changes contents to uppercase | {{Student.First_Name|upper}} | JANE |
| trim | Trim spaces or text from the start and end of a string | {{Student.Email|trim('@example.edu')}} | jdoe |
4.4. Indentation
Twig is not indentation sensitive. Most of the examples in this article use indentation to improve readability, but it will function regardless of it. All three of the examples below will function identically.
{% if Appointment.Online == 1 %}
This is an online appointment!
{% endif %}
{% if Appointment.Online == 1 %}
This is an online appointment!
{% endif %}
{% if Appointment.Online == 1 %}This is an online appointment!{% endif %}
4.5. Streamlining Twig Statements
If you find yourself writing something like this:
{% if Reason.ReasonName == 'X' or Reason.ReasonName == 'Y' or Reason.ReasonName == 'Z' %}
Try using an array instead. Both will work, but the latter is cleaner and easier to update later.
{% if Reason.ReasonName in ['X','Y','Z'] %}
If you're repeatedly checking the same condition, like this:
Your {% if Appointment.Online == '1' or Appointment.CustomData.cf_123 == 'Hybrid Appt' %} online {% endif %} appointment has been scheduled for...
Location: {% if Appointment.Online == '1' or Appointment.CustomData.cf_123 == 'Hybrid Appt' %} To join, please click... {% endif %}...
Appointment policies: {% if Appointment.Online == '1' or Appointment.CustomData.cf_123 == 'Hybrid Appt' %} Please remember to... {% endif %}...
Consider setting a variable once and using that instead:
{% if Appointment.Online == '1' or Appointment.CustomData.cf_123 == 'Hybrid Appt' %}
{% set online = true %}
{% else %}
{% set online = false %}
{% endif %}
Your {% if online %} online {% endif %} appointment has been scheduled for...
Location: {% if online %} To join, please click... {% endif %}...
Appointment policies: {% if online %} Please remember to... {% endif %}...
This one is more minor, but in most cases instead of writing this:
{% if Appointment.Location != '' %}
You can write the following. This will return true if that field is not false, blank, or 0.
{% if Appointment.Location %}
Part 5. Getting Help
If you're a primary SysAdmin for your TracCloud instance and you need some help with Twig or HTML, feel free to reach out to us. Scroll all the way to the top of this page and click the "Support" tab to visit our helpdesk.