This guide is for course providers using the Cademy Admin dashboard. Mail Merge tags (merge fields) are placeholders that Cademy replaces with information from the person and record connected to an email, such as a first name, a course date, a venue or a link.
A Mail Merge tag uses double curly brackets. For example, {{student.first_name}} becomes the recipient's first name.
Do not add a # before the tag. #{{student.first_name}} is not the correct current format.
The record you email controls the information available. A Contact has no booking, course or date. An Order or a Registration does. See Choose the Right Record Before Adding Tags below.
Who Can Use Mail Merge Tags
System Admin: Can add Mail Merge tags to saved templates and use them in available manual email actions.
Course Owner: Can add Mail Merge tags to saved templates and use them in available manual email actions.
Facilitator: Cannot manage saved templates under Settings > Email Templates. They can use Mail Merge when an available manual email action lets them email records they manage.
Full List of Mail Merge Tags (Merge Fields)
The Mail Merge menu is the source of truth for the choices currently available in your editor. The built-in choices are grouped below.
Person Tags: Name, Email, Phone and Address
First Name and Last Name
Email and Telephone
Address - Full
Address - Address Line 1, Address - Address Line 2, Address - City, Address - Region, Address - Postcode and Address - Country
Provider Tags: Account Name, Location, Bio and Social Links
Review Capture Link appears before the other provider choices in the menu. Its limitations are explained under links below.
Educator account name, Educator location, Educator bio and Educator terms of service
Website, Twitter, Facebook, Linkedin, Instagram, Youtube and Pinterest
Course, Date and Booking Tags
Course name, Course location, Delivery method and Description
Start date & time and End date & time
Spaces booked and Total paid
Zoom / Video Call join link
Course location inserts the venue address, not the saved location’s Name, Public note or Private / internal note. In manual emails, Course location uses the directly linked date’s non-empty address, otherwise the course address. It does not separately look up a parent block’s address for a child date.
Description uses the course’s stored plain-text description. If that value is missing, the result can be blank even when the course page has a formatted description. Check Preview and use the required wording directly if it is missing.
Occurrence Name inserts the date’s Session name. Occurrence Description inserts the date’s Description. These are text values, not links. For room numbers or arrival details that change by date, see Set Up Automatic Confirmation and Reminder Emails.
Link and Button Tags
Receipt / Invoice link
Certificate Link
Add to Calendar Link
Course Page Link and Course Forum Link
Feedback Link and Feedback Button
Course Forum Button
Course access button and Course access link
What Each Link Tag Needs to Work
Receipt / Invoice link: use an Order email. From a Registration created from an Order, the sent email links that Order’s invoice, but Preview shows a different address. A Registration that was not created from an Order gets no invoice link.
Add to Calendar Link: needs a booking on a course with dates. See the calendar sections below.
Certificate Link: requires the correct participant/course context and an existing certificate that has not been revoked. A URL appearing in Preview does not prove that a certificate has been issued.
Feedback Link and Feedback Button: emails prepared with that Registration’s feedback request can use its personal feedback link. A normal manual email with course context uses the course’s sign-in feedback page instead. Without the necessary request or course/provider details, the link is blank. Not every Feedback Link bypasses sign-in.
Course access link and Course access button: use the message body, with the intended recipient’s course/registration context. Preview can show a placeholder rather than a usable sign-in link. Do not copy one person’s rendered access link into another person’s email.
Course Page Link and forum links need the correct course/provider details. A link does not itself prove that the recipient has permission to view the destination.
Review Capture Link is the older course sign-in feedback-page link. It is not a personal feedback-request link. Use the current Feedback choices when preparing feedback-request content, then check the actual sending context.
Choose the Right Tag for Common Details
Course venue: Choose Course location. Address - Full is the person’s own address.
Social links: Choose the relevant provider link, or add an ordinary hyperlink if the destination is fixed.
A fixed address, instruction or link: Type it as ordinary text or add a normal hyperlink. Mail Merge is only needed when the value should change with the recipient or record.
Parking, access or arrival instructions: a saved location’s Public note and Private / internal note are not Mail Merge choices. Type fixed instructions as ordinary text, or use Occurrence Description for details that change by date: see Set Up Automatic Confirmation and Reminder Emails.
A participant's own custom answer: Use a template with a checked Contact custom-field tag and preview from that participant’s record. Do not assume a Registration field is a Contact field.
Add the Course Duration to Confirmation Emails
There is no single course duration tag. Add Start date & time and End date & time from Mail Merge with ordinary words around them. For example, type “Your course runs from”, insert Start date & time, type “to”, then insert End date & time.
If every date of a course lasts the same time, you can type the duration as ordinary text in that course’s template. To find which template sends the confirmation, see Set Up Automatic Confirmation and Reminder Emails.
Show the Discount Code Used in an Order Confirmation Email
There is no Mail Merge tag for a discount code. To let customers check the discount, add Receipt / Invoice link to the confirmation template. The invoice it opens shows the amount taken off on a Discount line. It does not always show the discount code.
If the email itself must mention the discount, type it as ordinary text in a template used only where that discount applies.
Send a Calendar Invite When Someone Registers Onto a Course
Cademy does not attach a calendar invite to learner emails. Instead, add Add to Calendar Link to the confirmation template the course uses. The link downloads a calendar file (.ics) for the booked date. For a block, each session is added as its own event. The venue and joining link are included when the booking gives course access.
The link works only for courses with dates. Facilitators can receive calendar invitations for the dates they teach: see Choose Facilitator Emails and Calendar Invitations.
Why the Calendar Link in a Confirmation Email Gives an Error
The Add to Calendar Link shows an error instead of a calendar file when Cademy cannot match it to one dated booking:
The booking has no course date, for example an on-demand booking. Leave the link out when there is no booked date.
The order or registration has been deleted.
The email was sent from Contacts, so it has no booking.
The order includes several dated courses and the email is not tied to one of them. Send from the participant’s Registration instead.
To check the link, send the email to yourself from a test registration on a dated course, then select the link.
Choose the Right Record Before Adding Tags
An Order is a purchase record. It can contain several courses. A Registration is one person’s place on one course. Choose the sending record before choosing tags:
Order: person, provider and Order information, plus one relevant course/date. A course tag does not list every course in the Order. Spaces booked uses the spaces on one course entry chosen for the recipient; Total paid uses the whole Order’s total paid, not that participant’s payment.
Registration or Registrant: person, provider and the Registration’s course and date or block. When it was created from an Order, a sent email takes Total paid, Spaces booked and the Receipt / Invoice link from that Order.
Contacts: person and provider information. A normal email from the Contacts list has no specific course, date, Order or Registration context.
Orders inside a course: an Order email sent from a course’s Orders tab uses that course’s details, even when the Order includes other courses. Also email each order’s registrants adds only the registrants on that course. In Registrants, each Registration supplies its own course and date.
Waitlist: person, provider and the course recorded on the waitlist entry. Its date is included when the entry has a specific date. It is not an Order or a payment record.
Course invitation: person, provider and the course being shared. The invitation does not provide a completed Order or Registration.
Automatic course email: the triggering Order or Registration supplies the context. A scheduled reminder or follow-up can use a particular session within a booked block. A manual preview is not proof of every automatic email’s values.
Inbox message: Mail Merge is not processed, even if the editor offers the control. Tags in the message remain text.
Add a Mail Merge Tag to the Email Body
Use a manual email when you want to insert and check tags for a specific recipient. Use an Order for purchase information, or the exact Registration for a participant’s course/date information.
Open the email panel for one test record: follow steps 1 and 2 under Preview an Email With a Real Test Record below.
Choose a saved custom template, or enter a Subject and Email body.
Place the cursor in the body where the value should appear. Select Mail Merge in the editor toolbar, then choose the built-in value you need.
Keep the inserted tag exactly as Cademy creates it. Add ordinary wording around it.
Preview the result and close without sending: follow steps 4 to 6 of the same section.
Example of the Mail Merge menu open in the email panel for one selected registration.
For example, a dated Registration can supply the values in: Hello {{student.first_name}}, thank you for booking {{course.name}}. Check the actual result in Preview.
To keep tags in a reusable template, a System Admin or Course Owner opens Settings > Email Templates and the saved custom template, inserts the tags in Email Body, then opens Save and selects Save. Editing a manual email does not update the saved template. See Create and Reuse Email Templates.
Add a Mail Merge Tag to the Subject Line
The Mail Merge menu inserts into Email Body, not directly into the Subject field. To add a simple text or date value to the Subject:
Insert the required tag into Email Body using Mail Merge.
Copy the complete inserted tag.
Paste it into the Subject field.
Remove it from the body if it is not needed there.
If you are editing a saved custom template in Settings, open Save, select Save and wait for Template updated.
Preview the email from a suitable record.
Use this method for simple values such as First Name, Course name, Start date & time. Keep buttons and links out of the subject.
Include Room or Arrival Details From Each Course Date
Use Occurrence Description when room numbers or arrival instructions change between course dates. Save the details in each date’s Description, then insert the tag in the confirmation and reminder templates.
Add the Information to the Date
Saving the details in the date’s Description is explained in Set Up Automatic Confirmation and Reminder Emails.
Add the Tag to Each Email Template
Adding the Occurrence Description tag to each template is explained in Set Up Automatic Confirmation and Reminder Emails.
Check the Result for the Intended Date
Checking the result for one date is explained in Set Up Automatic Confirmation and Reminder Emails.
Use Custom Fields in Emails
Custom values can come from the email recipient’s Contact, the connected Course or the connected Occurrence (a course date or block). A custom-field tag needs the matching field and a stored value on that record.
Contact fields: use the current recipient’s value, not every guest’s answers.
Course fields: use the connected course’s stored value.
Occurrence fields: use values available from the date or block connected to the email. Do not assume a manual email to a child date also loads its parent block’s custom values.
The Mail Merge toolbar does not list custom fields. An email editor that has Mail Merge can offer them in a list when you type {{ in the message. Do not guess a tag from the field’s display name. If you cannot add a custom-field tag this way, contact Cademy Support with the field name and the email.
If an existing custom template already contains a custom-field tag, check it before reuse:
Confirm that the intended Contact, Course or Occurrence contains the value. The linked field guides explain where these fields are set up and populated.
Select that recipient’s relevant test record, select Email or Send Email, whichever your list shows, then choose the saved custom template.
Select Preview and compare the displayed value with the record. If it is missing or unreadable, do not rely on it in a bulk email. Use ordinary wording for this message or ask Support to check the field/tag combination.
Simple text and numbers are easier to check. A custom date does not automatically use the built-in course date format. Address, File Upload, object and multiple-answer fields can produce unreadable or joined values.
Registration, Organisation and User fields are not interchangeable with Contact fields. A custom tag does not build a list of every course, guest or form answer.
See Create Custom Contact Fields for Your Forms and Add Custom Fields to Courses and Course Dates for field setup. Their setup controls are separate from email tag insertion.
Preview and Test Personalised Values
The Settings Preview Shows Layout Only, Not Real Values
Opening Preview... under Settings > Email Templates does not use a real Contact, Order, Registration, course or date. Raw tags can remain visible there. That does not show whether the tag will resolve for a real recipient.
Example of Preview... for a saved template, with raw tags still visible.
Preview an Email With a Real Test Record
Open the Orders or Registrations list as a System Admin. A Course Owner or Facilitator opens the assigned course’s Registrants list.
Select only the checkbox beside the authorised test record you need, then select Email or Send Email, whichever your list shows. Check the displayed selection count.
Choose the saved custom template, or enter the subject and message. If you edited a template in Settings, save and reopen it there first.
If you used Orders, leave Also email each order’s registrants unchecked for a test addressed only to you.
Select Preview. Check the displayed recipient, subject, person, course, date and custom values. A preview of many records shows a sample only. Preview from a Registration does not load its Order, so Total paid, Spaces booked and the Receipt / Invoice link are not final there.
Close the preview and email panel without selecting Send when you are only checking.
Example of the preview for one test registration, with the first name and course name filled in.
Preview does not send an email, confirm attachment arrival or test recipient access. For a delivery test, send to a test record with your own email address and check the message and links before a bulk send. Do not use a real customer as a test recipient.
Why a Mail Merge Tag Shows Blank, Wrong or as Text
The tag is visible exactly as typed: Check whether the email was created through Cademy Inbox. Inbox does not process Mail Merge. For a built-in tag, insert a fresh copy using Mail Merge. For a custom-field tag, keep the existing tag and ask Support to check it.
The value is blank: The selected record may not contain that information. For example, a Contact-only email has no course date or payment.
The course or date is wrong: Use the exact Registration instead of a broad Contact or multi-course Order. Check whether it points to a whole block or an individual session.
The address is wrong: Use Course location for the venue and a person Address choice for the recipient's address. Preview from the exact Registration when a scheduled date may use a different location from the course default.
End date or time is blank: Check that the selected course/date has an end value, then insert the current End date & time choice. Reinserting a tag does not create missing date information.
A custom value is blank: Confirm the field has a value on the exact Contact, Course or Occurrence used for the preview.
A custom value says [object Object] or looks joined together: The field stores a complex or multiple value. Use a simpler custom text field or ordinary email text.
The template will not save: Check the error message and required template fields. If it reports a tag/parsing error, replace incomplete or altered built-in tags using Mail Merge. For a custom-field tag, keep the existing tag and ask Support to check the error.
A certificate link is missing or fails: Confirm that a certificate has been issued for that recipient and test from the relevant Registration.
Limits for Bulk, Multi-Course and Guest Emails
Bulk sends are personalised one recipient at a time. Each selected record supplies its own available values.
A multi-course Order does not become a course summary. Cademy uses one relevant active course context for a recipient. Use Registrations when the exact course and date must be unambiguous.
A person tag does not list every guest. It represents the current email recipient.
A custom field tag does not aggregate every booking-form answer. Add the exact information as normal text, or send from individual Registrations when each participant needs their own value.
Related Guides
Frequently Asked Questions
Can I combine Mail Merge tags with normal text?
Yes. Add ordinary wording around the tags. Only the tag is replaced.
Why does a tag show with a # before it?
The current syntax does not use a #. For a built-in tag, replace the old tag using Mail Merge. For a custom-field tag, keep the existing tag and ask Support to check its format.
Do Mail Merge tags work in Cademy Inbox?
No. Inbox does not process Mail Merge, so tags stay as text. For finding, replying to and starting Inbox conversations, see Reply to Customer Messages and Enquiries in Inbox.
Are email Mail Merge tags the same as certificate fields?
No. In an email, use Mail Merge in the email editor. In a certificate template, use the certificate editor's Add menu and its own field options. See Set Up Automatic Certificates for a Course.
