Mail template variables
What are variables?
When you create email templates in Equipme Pro, you can use variables to insert dynamic information automatically. This works for internal notifications to your own team and for the notifications your customers receive.
Variables act as placeholders. When the email is sent, they are replaced with real data such as names, services, prices or links. Your templates stay flexible, and every email still shows the right information.
Each template has its own set of variables. A variable only works in the templates it is listed for. The general and address variables are the exception: you can use them everywhere.
Write variables exactly as listed
Copy variable names exactly as they appear in the tables. Spelling and capitalization differ between templates. The recipient's name, for example, is FullName in the order confirmation but fullName in the invoice email. A variable that is spelled differently will not be filled.
Working with lists
Some variables contain several entries, for example all items of an order. To display them, loop through the list:
{{#each Items}}
- {{ItemName}}
{{/each}}Inside the loop, you use the item variables without a prefix. In the tables, the Items[]. notation only shows that a variable belongs to a list.
Nested lists
Some lists contain further lists. The expiration reminder for you, for example, groups services by customer. You need a loop inside a loop:
Using conditions
A variable might not always contain a value. Variables marked as optional in the tables can be empty, and list entries such as selected options are not always present. Wrap these in a condition:
The condition makes sure the value is only used when it exists.
Important
If a variable like Options is used without a condition and no data is available, the email rendering fails and the email is not sent. The content is not simply left empty.
Combining loops and conditions
This keeps your templates clean while still handling optional data correctly.
True/false variables
Variables described as true/false let you show text only in certain cases. For example, show a line only for cancelled services:
Variables that can contain HTML
Some variables, such as ticket descriptions or order notes, can contain HTML formatting. This is noted in the description.
General variables
These variables are available in every template.
Supplier name (your company)
supplierName
Email subject
Subject
Language
ln
Primary color
primaryColor
Header image
headerImage
Header image width
headerImageWidth
Yes
Header image height
headerImageHeight
Yes
Logo (default)
NormalLogoLink
Logo width (default)
NormalLogoWidth
Yes
Logo height (default)
NormalLogoHeight
Yes
Logo (contrast)
ContrastLogoLink
Logo width (contrast)
ContrastLogoWidth
Yes
Logo height (contrast)
ContrastLogoHeight
Yes
Imprint link
imprintLink
Privacy policy link
privacyPolicyLink
Terms and conditions link
termsAndConditionsLink
Address variables
Your company address. Available in every template.
Address name
addressName
Street
addressStreet
Postal code
addressCode
City
addressCity
Country
addressCountry
Order item variables
Several order templates share the same item structure. Inside each loop, you can use these variables.
Item name
ItemName
Recurring cost (per item)
TotalRecurring
One-time cost (per item)
TotalOnce
Quantity
Quantity
Selected options
Options
Supplier of the item
ItemSupplier
Order number (per item)
OrderNumber
Order ID (per item)
OrderId
Yes
Order link (per item)
OrderLink
Assigned location(s)
LocationNames
Assigned employee(s)
EmployeeNames
Requester(s)
RequesterNames
Expiration item variables
The expiration and cancellation lists in both expiration reminders share this structure.
Service name
Service
Quantity
Total
Assigned users
Users
Days until expiration
ThresholdInDays
Whether the service has been cancelled (true/false)
Canceled
Customer name
CustomerName
Link to the service detail page
DetailPageLink
Orders
New order received
Template: OrderReceptionMail
Sent to your team when a customer submits orders, cancellations, revocations, changes or requests. Each list uses the order item variables.
Customer name
customerName
Customer number
customerNumber
Full name of the recipient
FullName
New orders
orders
Cancellations
cancellations
Revocations
revocations
Changes
changes
Requests
requested
Download link for the order document
linkDownload
Link to the order
link
Order ID
orderId
Note the customer added to the order. Can contain HTML
orderNote
All assigned locations
AllLocationNames
All assigned employees
AllEmployeeNames
Pending orders summary
Template: OrdersPendingModel
A summary of new orders, changes and requests that are waiting for you, grouped by customer.
Link to the order overview
Link
Full name of the recipient
FullName
One entry per customer
customers
Number of new services
customers[].NewServices
Number of new orders
customers[].NewOrders
Number of new changes
customers[].NewChanges
Number of new requests
customers[].NewRequests
Customer name
customers[].CustomerName
Order placed
Template: OrderPlacedMail
Sent when an order is placed. The items are split into lists by type, and each list uses the order item variables.
Link to the order
OrderLink
Full name of the recipient
FullName
Whether section headings should be shown (true/false)
ShowSectionHeader
New orders not yet confirmed
UnconfirmedItems
Confirmed orders
ConfirmedItems
Changes
ChangeItems
Cancellations
CancellationItems
Requests
RequestItems
Other items
OtherItems
Order date
OrderDate
Order ID
OrderId
Recurring total
TotalRecurring
One-time total
TotalOnce
Number of items
ItemCount
All assigned employees
AllEmployeeNames
All assigned locations
AllLocationNames
Order confirmation
Template: OrderConfirmationMail
Sent when an order is confirmed. Items uses the order item variables.
Link to the order
OrderLink
Full name of the recipient
FullName
Ordered items
Items
Order date
OrderDate
Order number (overall)
OrderNumber
Recurring total
TotalRecurring
One-time total
TotalOnce
Number of items
ItemCount
Purchase order
Template: PurchaseOrderMail
Sent together with a purchase order.
Full name of the recipient
fullName
Order ID
orderId
Items left in the cart
Template: CartItemsPendingMail
Reminds users of items that are still in their cart. If the cart holds more entries than the email lists, the unlisted variables sum up the rest.
Full name of the recipient
FullName
Link to the cart
link
Number of cart entries not shown in the list
unlistedCount
Number of services not shown in the list
unlistedServicesCount
Recurring total of the entries not shown
unlistedTotalRecurring
One-time total of the entries not shown
unlistedTotalOnce
Customer name
customerName
Items in the cart
items
Service name
items[].ServiceName
Employee the item is intended for
items[].Fullname
Quantity
items[].Count
Location
items[].Location
Recurring total
items[].TotalRecurring
One-time total
items[].TotalOnce
Fulfillment status changed
Template: FulfillmentStatusChangedMail
Sent when the fulfillment status of one or more items changes. Use the Reached variables to show a different text for each status.
Full name of the recipient
FullName
Whether the notification covers several items (true/false)
Multiple
Status reached: in process (true/false)
ReachedInProcess
Status reached: ready for delivery (true/false)
ReachedReadyForDelivery
Status reached: delivered (true/false)
ReachedDelivered
Status reached: cancelled (true/false)
ReachedCancelled
Recurring total
RecurringPriceTotal
One-time total
OneTimePriceTotal
Affected items
Items
Service instance ID
Items[].InstanceId
Order ID
Items[].OrderId
Product name
Items[].ProductName
Selected options
Items[].OptionsString
Quantity
Items[].Quantity
Assigned employee
Items[].EmployeeName
Yes
All assigned employees
Items[].EmployeesString
Category
Items[].NodeName
Yes
All categories
Items[].NodeNamesString
Recurring price
Items[].RecurringPrice
One-time price
Items[].OneTimePrice
Product image
Items[].ImageUrl
Order reference
Items[].OrderReference
Order date
Items[].OrderDate
Service reservation
Template: ServiceReservationMail
Sent when services are reserved for a customer.
Full name of the recipient
FullName
Customer name
CustomerName
Customer number
CustomerNumber
Reserved items
Items
Product name
Items[].ProductName
Quantity
Items[].Count
Configuration
Items[].Configuration
Person who made the reservation
Initiator
Organizational unit
OrganizationalUnitName
Approvals and self-service
Order approval request
Template: OrderAuthorizationRequestMail
Sent to approvers when an order needs their approval.
Full name of the recipient
fullName
Customer name
customerName
Link to the approval
link
Order request approved
Template: OrderRequestApprovedMail
Sent when an order request has been approved.
Full name of the recipient
fullName
Approved services
services
Service name
services[].service
Assignment (employee or location)
services[].allocation
Quantity
services[].total
Email address of the approver
approvingUserEmail
Customer name
customerName
Self-service request
Template: SelfServiceRequest
Sent when an employee submits a request through self-service. The IsLifecycle variables tell you whether a service is added, changed or removed.
Full name of the recipient
fullName
Customer name
CustomerName
Email address of the requester
InitiatorMail
Requested items
Items
Service instance ID
Items[].InstanceId
Item name
Items[].ItemName
Selected options
Items[].Options
Quantity
Items[].Quantity
Recurring total
Items[].TotalRecurring
One-time total
Items[].TotalOnce
Request adds a new service (true/false)
Items[].IsLifecycleCreated
Request removes a service (true/false)
Items[].IsLifecycleDeleted
Request changes a service (true/false)
Items[].IsLifecycleUpdated
Number of items
ItemCount
Recurring total
TotalRecurring
One-time total
TotalOnce
Link to the request
Link
Order date
OrderDate
Order ID
OrderId
Self-service request decision
Template: SelfServiceOrderRequestApprovalMail
Sent when a self-service request has been approved or rejected.
Full name of the recipient
fullName
Requested items
items
Service name
items[].service
Selected options
items[].options
Whether the item was created (true/false)
items[].Created
Quantity
items[].total
ID of the requester
items[].InitiatorId
Name of the requester
items[].InitiatorName
Email address of the requester
items[].InitiatorMail
ID of the employee the item is for
items[].TargetUserId
Name of the employee the item is for
items[].TargetUserFullName
Email address of the employee the item is for
items[].TargetUserMail
Category
items[].Node
Cloud service name
items[].CloudServiceName
Email address of the person who decided
actingUserEmail
Customer name
customerName
Reason for rejection
rejectionReason
Services and runtime
Auto-renewal reminder
Template: AutoRenewalReminderMail
Lists services that will renew automatically soon.
Full name of the recipient
FullName
Renewal date
ExpirationDateString
Services that will renew automatically
Items
Service name
Items[].Service
Quantity
Items[].Total
Assigned users
Items[].Users
Days until renewal
Items[].ThresholdInDays
Runtime extension on renewal
Items[].RuntimeExtension
Whether the service has been cancelled (true/false)
Items[].Canceled
Customer name
Items[].CustomerName
Link to the service detail page
Items[].DetailPageLink
Expiration reminder for customers
Template: ExpirationReminderCustomerMail
Sent to your customers about their expiring and cancelled services. Each list uses the expiration item variables.
Full name of the recipient
FullName
Customer name
CustomerName
Days until expiration
ThresholdInDays
Expiration date
ExpirationDateString
Whether the recipient uses one of the services (true/false)
ReceiverIsAffectedUser
Cancelled services that end soon
CancelledItems
Cancelled services that end today
CancelledItemsToday
Services that expire soon
ExpiringItems
Services that expire today
ExpiringItemsToday
Expiration reminder for you
Template: ExpirationReminderSupplierMail
Sent to you as the supplier. It groups expiring and cancelled services by customer, so you need a loop inside a loop (see nested lists). Each inner list uses the expiration item variables.
Full name of the recipient
FullName
One entry per customer
CustomerItems
Customer name
CustomerItems[].CustomerName
Cancelled services of this customer that end soon
CustomerItems[].CancelledItems
Cancelled services of this customer that end today
CustomerItems[].CancelledItemsToday
Services of this customer that expire soon
CustomerItems[].ExpiringItems
Services of this customer that expire today
CustomerItems[].ExpiringItemsToday
Service assignment changed
Template: ServiceAssignmentChangeMail
Sent when services are assigned to a different employee or location.
Full name of the recipient
fullName
Customer name
customerName
Changed assignments
changes
Item name
changes[].ItemName
Location
changes[].Location
Employee
changes[].Employee
Link to the service
changes[].Link
Service ID
changes[].ID
Receipt confirmation
Template: ReceiptConfirmationMail
Asks the recipient to confirm that a service has arrived.
Full name of the recipient
FullName
Service name
ServiceName
Link to confirm receipt
Link
Receipt confirmation reminder
Template: ReceiptConfirmationReminderMail
Lists deliveries whose receipt has not been confirmed yet.
Deliveries without receipt confirmation
Items
Service instance ID
Items[].InstanceId
Link to the service instance
Items[].InstanceLink
Product name
Items[].ProductName
Customer ID
Items[].CustomerId
Employee ID
Items[].EmployeeId
Yes
Employee first name
Items[].FirstName
Employee last name
Items[].LastName
Employee email address
Items[].EmployeeEmail
Days since delivery
Items[].DaysAgo
Full name of the recipient
FullName
Platform domain
OriginDomain
Tickets
New ticket
Template: NewTicketMail
Sent when a ticket is created.
Full name of the recipient
FullName
Name of the person who created the ticket
CreatorName
Contact person
ContactName
Ticket type
Type
Ticket ID
TicketID
Ticket subject
TicketSubject
Customer name
CustomerName
Ticket description. Can contain HTML
Description
Affected services
AffectedServices
Link to the ticket
Link
Ticket assigned to an agent
Template: TicketAgentAssigned
Sent when a ticket is assigned to an agent.
First name of the person who triggered the notification
TriggeredByFirstname
Last name of the person who triggered the notification
TriggeredByLastname
Username of the person who triggered the notification
TriggeredByUsername
Ticket ID
TicketID
Ticket subject
TicketSubject
Full name of the recipient
FullName
Ticket assigned to a team
Template: TicketGroupAssignedMail
Sent when a ticket is assigned to a team.
First name of the person who triggered the notification
TriggeredByFirstname
Last name of the person who triggered the notification
TriggeredByLastname
Username of the person who triggered the notification
TriggeredByUsername
Ticket ID
TicketID
Ticket subject
TicketSubject
Name of the assigned team
TeamName
Full name of the recipient
FullName
New ticket message
Template: TicketMessageReceived
Sent when a new message is added to a ticket.
First name of the person who triggered the notification
TriggeredByFirstname
Last name of the person who triggered the notification
TriggeredByLastname
Username of the person who triggered the notification
TriggeredByUsername
Ticket ID
TicketID
Ticket subject
TicketSubject
Full name of the recipient
FullName
Message content. Can contain HTML
Content
Ticket message forwarded
Template: TicketMessageForwarded
Sent when a ticket message is forwarded, including its attachments.
First name of the person who triggered the notification
TriggeredByFirstname
Last name of the person who triggered the notification