This article explains Substitution Tags on 12twenty, the placeholder tags that are replaced with specific information from Students, Employers, and Job Postings when contacted by an administrator via 12twenty mailing tools. This article includes descriptions for all the Substitution Tags available for Emails, Email Templates, and Notifications on 12twenty.
Sections
- Substitution Tag Overview
- Student Messaging Substitution Tags
- Contact, Job, and Event Substitution Tags
- Notification Substitution Tags
Substitution Tags Overview
Substitution Tags are placeholders for other values that get replaced with the user-specific value when an email is sent to multiple users. For example if we were to email multiple students and wrote "Dear Students" it's obvious to the user that the email wasn't targeted towards them exactly. With Substitution tags we can instead write "Dear {{FirstName}}" and each student will see their own name on the email.
The available substitution tags differ based on who you are emailing, for example messaging Students on 12twenty offers many more Substitution Tags compared to when messaging a Contact on your site. There are also substitution tags available for different kinds of notifications, most often these are used with Events and Job Postings or OCIs.
Best Practices
When using Substitution Tags it is important to remember the following:
- Instead of typing in the Substitution Tag, select if from the drop-down list:
- Substitution Tags will always display in Emails on Student or Contact Profiles and under the Email Activity section of the site, 12twenty's user Interface will not display the placeholder value. For example, {{FirstName}}{{LastName}} will display on the email in 12twenty instead of John Smith.
- If a Substitution Tag was used for a value that does not exist it will be left blank or empty on the email.
- 12twenty always recommends sending a test email to yourself before your first time emailing student in bulk using Substitution Tags.
Student Messaging Substitution Tags
Messaging student via 12twenty provides the most substitution tags out of any messaging or notification type on the platform, these tags will always reference a value from the student's profile if available. If no applicable value is available on the student profile then the substitution tag will be left empty on the email. Only a few substitution tags can be used in the Subject Line of an email, the rest can only be used in the body of the email. The list below includes all the substitution tags available when messaging students from the Student Directory.
| Substitution Tag | Description | Location |
| {{FirstName}} | Student's First Name. | Subject Line/Email Body |
| {{LastName}} | Student's Last Name. | Subject Line/Email Body |
| {{Student.PreferredName}} | Student's Preferred Name. | Subject Line/Email Body |
| {{Student.GraduationTerm}} | Student's Graduation Term. | Subject Line/Email Body |
| {{Student.GraduationYear}} | Student's Graduation Year. | Subject Line/Email Body |
| {{MagicLoginLink}} | Provides Unique Link to Login bypassing Username and Password. More information here. | Email Body |
| {{Student.CollegeSchoolList}} | List of Colleges/Schools associated with the Student. | Email Body |
| {{Student.DegreeList}} | List of all Degrees associated with the student. | Email Body |
| {{Student.DegreeLevel}} | Student's Degree Level. | Email Body |
| {{Student.UndergraduateMajorList}} | All Undergraduate Majors associated with the student. | Email Body |
| {{Student.UndergraduateMinorList}} | All Undergraduate Minors associated with the student. | Email Body |
| {{Student.Program}} | The Student's Program. | Email Body |
| {{Student.PreferredIndustryList}} | The student's list of Preferred Industries. | Email Body |
| {{Student.PreferredFunctionList}} | The student's list of Preferred Functions. | Email Body |
| {{Student.PreferredCityList}} | The student's list of Preferred cities. | Email Body |
| {{Student.Gender}} | Student's Gender. | Email Body |
| {{Student.LinkedinURL}} | Student's Linkedin URL. | Email Body |
| {{Student.WorkAuthorizationDetailed}} | Student's Work Authorization from the Detailed Picklist. | Email Body |
| {{Student.WorkAuthorizationConsolidated}} | Student's Work Authorization from the Consolidated Picklist. | Email Body |
| {{Student.CountryofCitizenshipList}} | The student's list of Countries of Citizenship. | Email Body |
| {{Student.AssignedAdvisorList}} | A list of Advisors assigned to the student. | Email Body |
| {{Student.AssignedAdvisorEmailAddressList}} | A list of emails for Advisors assigned to the student. | Email Body |
| {{Student.EmailAddress}} | The student's school email address. | Email Body |
| {{Student.PreferredEmailAddress}} | The student's personal/preferred email address. | Email Body |
Contact, Job, and Event Messaging Substitution Tags
Bulk-selecting Contacts, Jobs, OCIs, or Events from their respective directories and choosing the option to message them only allows for the {{FirstName}} and {{LastName}} tags. When messaging contacts this will always use the contact's first and last name, but when messaging Jobs, OCIs, or Events in bulk administrators have the option to select who they want to message using checkboxes along the top of the window. The {{FirstName}} and {{LastName}} tags apply to whatever options are selected.
Instead of breaking down the Substitution Tags, we've noted where the respective recipients can be found for each type.
Contacts
Contacts only ever use the selected contact's First and Last name as placeholder values.
Jobs and OCIs
-
Job Posting Owner: Job Posting Owner found on the Job Posting tab.
Applicable to both Job Postings and OCIs.
-
Primary OCI Contact: Primary OCI Contact found on the Registration tab.
Only applicable to OCIs.
-
All Applicants: Students under the Applicants tab.
Applicable to both Job Postings and OCIs.
-
All Scheduled Applicants: Students with a time slot under the Schedule tab.
Only applicable to OCIs.
Events
-
-
Career Center Contact: Career Center Account Manager
-
Event Manager: Primary Event Contact
-
Student Registrants: Students in the Registered Students tab
-
Career Center Contact: Career Center Account Manager
Notification Substitution Tags
Notifications for specific modules are found under Site Settings > Site Management. Select the module you want to view notifications for and then choose the "Notifications" tab along the top of the page.
Each module with notifications has its own unique Substitution Tags depending on the needs of the module, for example Experiential Learning has separate Substitution Tags from the Mentorship module because Experiential Learning Notifications include things like the name of the experience while Mentorship notifications might reference the names of the Mentor or Mentee.
Due to the amount of unique substitution tags available for each module, if you have questions about what a specific Substitution Tag on a notification is referencing 12twenty recommends using the "Send me a Test Email" option under the 2-dot action button to the top right of the notification you are editing:
If you still have question please consider contacting support@12twenty.com for more information.