Configure notification template macros
A macro is a bracketed field name that Zenoti replaces with an actual value when a notification is sent. A macro can be spelled correctly, accepted by the template editor, and still arrive blank β because the notification type does not support it, because it depends on a setting that is off, or because the link carrying it was inserted with a fixed protocol. This article explains those cases and lists the macros each notification type supports, so you can confirm a macro will resolve before you activate the template.
On this page
- Why a macro renders empty
- Macros inside links
- Common macros (available in all templates)
- Virtual appointment link macros
- Appointment confirmation macros
- Group appointment confirmation macros
- Appointment declined macros
- Appointment cancellation macros
- Appointment reschedule macros
- First appointment reminder macros
- Second appointment reminder macros
- Appointment no-show macros
- Appointment completion to guest macros
- Thank you macros
- Invoice and payment macros
- Payment made macros
- Receipt header and footer macros
- Membership lifecycle macros
- Package macros
- Gift card macros
- Gift card POS (Point of Sale) macros
- Loyalty macros
- Employee notification macros
- Inventory notification macros
- Queue and kiosk notification macros
- Authentication and link macros
- Custom macros
- Referral macros
- Push notification macros
Before you begin
- You need administrator access at the organization level.
- Macros are available when you edit a notification template at the organization level under Configuration > Notifications > Templates for email and text.
Permission: Edit under Organizations in the Administrator section of the security role (Configuration > Security > Security roles) is required for template editing.
Navigation
To insert macros into a template:
- Navigate to Configuration > Notifications > Templates for email and text at the organization level.
- Select Edit on the template you want to change.
- In the template editor, insert macros from the Available Macros list or type the macro name in brackets directly. The editor shows only the macros that are valid for the selected notification type.
Note about bracket notation: Most macros use square brackets β for example,
[GuestName],[StartTime]. A few older domain-specific notifications (inventory transfer, queue check-in, kiosk wait-time) use curly braces instead β for example,{TransferOrderNumber}. Use the exact bracket style shown in the macro tables below; the template engine looks up macros by the full bracketed name, and substituting one bracket style for another will leave the macro unreplaced in the sent message.
Why a macro renders empty
A macro that arrives blank in a sent notification is almost always one of two cases, and neither one produces an error when you save the template.
- The notification type does not support the macro. Each notification type supports a specific macro set.
[ConfirmLink]resolves in confirmation, reminder, reschedule and completion-to-guest templates but not in cancellation templates;[OrigStartTime]resolves only in reschedule templates. The template editor filters the macro list by notification type, so a macro the editor does not offer for the template you have open will not resolve there. - The macro depends on a setting that is off. The macro list does not filter by setting.
[GuestPaymentLink]is offered whether or not a payment link is issued during dunning, and it renders empty when that setting is off. A macro's presence in the list is not confirmation that it will resolve.
The following macros resolve only under the stated condition:
| Macro | Resolves only when |
|---|---|
[ConfirmLink] |
The template is a confirmation, reminder, reschedule or completion-to-guest template. |
[OrigStartTime] |
The template is a reschedule template. |
[GuestPaymentLink] |
Enable auto trigger of payment link when membership payment collection fails during dunning is on under Payment links. |
[SubmittedFormCopy] |
The form was submitted; Email copy of the form to guest on submission is enabled on the form; for guest-level forms, the organization has Only Webstore 2.0 enabled, or, for service-level forms, the form uses the HTML code builder type; and, for service forms, the form is associated with the service the notification is being sent for β a submitted form for a different service on the same appointment does not qualify. (The form-creation screen hides and disables this flag entirely for service forms built with the V1 (key-value pair) type, so it's only reachable on HTML-code service forms. Forms built with the newer JSON form builder are also not recognized as submitted by this macro.) |
Note: The form-level Email copy of the form to guest on submission setting is independent of the service-level Allow emailing of form link setting.
[SubmittedFormCopy]does not consult Allow emailing of form link β turning that setting on or off has no effect on whether the macro resolves. If the macro is arriving blank, check the conditions in the table above; changing Allow emailing of form link will not fix it.
A third case affects macros placed inside a hyperlink β see Macros inside links.
Macros inside links
When you insert a hyperlink into a template, the link dialog asks for the address and offers a protocol for that address. That choice decides whether a macro in the address expands when the notification is sent:
- If you select a fixed protocol, the editor writes that protocol in front of the address you typed and the macro inside the address is not expanded. The sent message links to the literal macro name.
- If you select the option that leaves the address unmodified, the macro expands and supplies the full address. Use this option for every link whose address carries a macro.
None of this is visible in the template. The macro name is spelled correctly, the editor accepts the link, and the template saves β the macro is right and the link is not.
Insert a link that carries a macro
- In the template editor, select the text you want to turn into a link.
- Open the link dialog.
- Enter the macro β including its brackets and nothing else β as the address.
- In the protocol list, select the option that leaves the address unmodified. Do not select a fixed protocol such as
http://orhttps://; the macro already supplies the protocol as part of the address it resolves to. - Save the link, then save the template.
- Use Send Test Email and click the link in the message you receive to confirm it resolves to a working address.
Macros that supply a complete address
Each of the following macros resolves to a full address on its own. Whenever one of them is placed inside a hyperlink, insert it with the address left unmodified.
Important:
[ServiceNameVideoLinkList]is not in the table above. It is inserted as message text rather than as a link address β see Virtual appointment link macros.
Worked example: In an appointment reminder template, you want the words "Confirm your appointment" to link to
[ConfirmLink]. Select the text, open the link dialog, enter[ConfirmLink]as the address, and choose the option that leaves the address unmodified. If you choose a fixed protocol such ashttps://instead, the sent email links tohttps://[ConfirmLink]and the guest reaches an error page.
Tip: After you insert or edit a link that carries a macro, use Send Test Email and click the link in the message you receive.
Common macros (available in all templates)
These macros are available in every notification template. They resolve to guest profile information and center/organization details.
Guest macros
| Macro | Description |
|---|---|
[FirstName] |
Guest first name |
[LastName] |
Guest last name |
[CustName] |
Full guest name (first and last) |
[PreferredName] |
Guest preferred or display name |
[Gender] |
Guest gender |
[DOB] |
Date of birth |
[GuestCode] |
Unique guest identifier code |
[GuestUsername] |
Guest login username |
[GuestReferralCode] |
Guest referral code for refer-a-friend programs |
[GuestDataLink] |
Link to the guest data or profile page |
[Name] |
Generic name field |
Center and organization macros
| Macro | Description |
|---|---|
[CenterName] |
Center or location name |
[CenterAddress] |
Center street address |
[CenterCity] |
Center city |
[CenterState] |
Center state or province |
[CenterZip] |
Center postal code |
[CenterCountry] |
Center country |
[CenterPhone] |
Center primary phone number |
[CenterPhone2] |
Center secondary phone number |
[CenterE-mail] |
Center email address |
[CenterAddlData1] |
The center's Enter additional text value |
[OrgName] |
Organization name |
[EntityName] |
Entity name (organization or center, depending on context) |
[TimeZoneCenter] |
Center time zone |
Virtual appointment link macros
Three macros carry a virtual meeting link into an appointment notification. They do not come from the same place, they are not offered in the same set of templates, and one of them is not a link-address macro at all.
[ServiceNameVideoLinkList]β the Zoom meeting link Zenoti creates, listed with each virtual service's name.[EmailVirtualAppointmentLink]β a virtual meeting link that staff add to the appointment by hand, for use in email content.[SMSVirtualAppointmentLink]β the same hand-added link, for use in text message content.
Which templates offer them
| Template | [ServiceNameVideoLinkList] |
[EmailVirtualAppointmentLink] and [SMSVirtualAppointmentLink] |
|---|---|---|
| Appointment Confirmation | Offered | Offered |
| Appointment Confirmation - Online Booking | Offered | Not offered |
| First Appointment Reminder | Offered | Offered |
| Second Appointment Reminder | Offered | Offered |
| Appointment Rescheduled | Offered | Offered |
| Group confirmation templates | Offered | Offered |
A guest receives the meeting link only from a template that carries one of these macros. Adding a macro to the confirmation does not put the link into the reminders or into the notice the guest receives when the appointment is moved β each of those is a separate template with its own content. Check every template in the guest's journey separately.
The online-booking confirmation is the case that most often goes unnoticed: Appointment Confirmation - Online Booking offers [ServiceNameVideoLinkList] but not the two hand-added link macros, so a link that staff type into the appointment by hand does not reach a guest who booked online through that confirmation.
How [ServiceNameVideoLinkList] renders
[ServiceNameVideoLinkList] is inserted as message text, not as a link address. Type it into the message body at the point where you want the list of virtual services to appear; do not put it in the address field of a link dialog.
- In an email, it renders each virtual service's name with its own link.
- In a text message, it renders each virtual service's name followed by the link.
Important:
[EmailVirtualAppointmentLink]and[SMSVirtualAppointmentLink]each supply a complete address, so they can go into a link address β with the address left unmodified, as described in Macros inside links.[ServiceNameVideoLinkList]cannot: it supplies names and links together as message text, and placing it in a link address produces a broken link.
Appointment confirmation macros
These macros are available in the appointment confirmation notification template. Use them when a guest books a new appointment and receives a confirmation message.
| Macro | Description |
|---|---|
[AppDate] |
Appointment date |
[AppCost] |
Appointment cost |
[StartTime] |
Appointment start time |
[EndTime] |
Appointment end time |
[Duration] |
Appointment duration |
[ServiceTherapistList] |
List of services and assigned providers |
[ServiceTherapistTimeList] |
List of services, providers, and scheduled times |
[TreatmentList] |
List of treatments in the appointment |
[ConfirmLink] |
Link for the guest to confirm the appointment |
[BookingURL] |
Online booking URL for the center |
[ServiceNameVideoLinkList] |
Zoom meeting link Zenoti creates, listed with each virtual service's name. Inserted as message text β see Virtual appointment link macros. |
[EmailVirtualAppointmentLink] |
Virtual appointment link for email templates (the link staff add by hand) |
[SMSVirtualAppointmentLink] |
Virtual appointment link for SMS templates (the link staff add by hand) |
[FirstServiceFormLink] |
Pre-service intake form link |
[RegistrationNotes] |
Appointment registration notes |
Note:
[ConfirmLink]is available in confirmation and reminder templates. It is also available in the Appointment Rescheduled and Appointment Completion to Guest templates, and is not available in cancellation templates.
Note: The Appointment Confirmation - Online Booking template is a separate confirmation template used for appointments booked online. It offers
[ServiceNameVideoLinkList]but not[EmailVirtualAppointmentLink]or[SMSVirtualAppointmentLink]β see Virtual appointment link macros.
Group appointment confirmation macros
These macros are available in the Group Appointment Confirmation notification template (template IDs 211, 221). This is a distinct template from the single-guest appointment confirmation and is used when a booking covers multiple guests β for example, a group class reservation or a couples' service.
| Macro | Description |
|---|---|
[AppDate] |
Appointment date |
[StartTime] |
Appointment start time |
[EndTime] |
Appointment end time |
[GroupName] |
Name given to the group booking (if configured) |
[GroupSize] |
Number of guests in the group |
[ServiceTherapistList] |
List of services and assigned providers across the group |
[ConfirmLink] |
Link for the group organizer to confirm |
[BookingURL] |
Online booking URL |
[ServiceNameVideoLinkList] |
Zoom meeting link Zenoti creates, listed with each virtual service's name. Inserted as message text β see Virtual appointment link macros. |
[EmailVirtualAppointmentLink] |
Virtual appointment link for email templates (the link staff add by hand) |
[SMSVirtualAppointmentLink] |
Virtual appointment link for SMS templates (the link staff add by hand) |
Note: Use the Group Appointment Confirmation template rather than the standard Appointment Confirmation when you need to reference the group as a whole. The single-guest confirmation does not support the
[GroupName]or[GroupSize]macros.
Appointment declined macros
These macros are available in the Appointment Declined notification template (template ID 5). This template is sent when a provider or center declines a requested appointment β it is distinct from appointment cancellation (which applies to confirmed appointments that are later called off).
| Macro | Description |
|---|---|
[AppDate] |
Requested appointment date |
[StartTime] |
Requested start time |
[ServiceTherapistList] |
Requested services |
[DeclineReason] |
Reason the appointment was declined (when provided) |
[BookingURL] |
Online booking URL for rebooking |
Note: The Appointment Declined template fires when the provider does not accept an appointment request. Use the Appointment Cancellation template for appointments that were previously confirmed and then cancelled.
Appointment cancellation macros
These macros are available in the appointment cancellation notification template. Use them when a guest or staff member cancels an appointment.
| Macro | Description |
|---|---|
[AppDate] |
Appointment date |
[StartTime] |
Appointment start time |
[EndTime] |
Appointment end time |
[Duration] |
Appointment duration |
[ServiceTherapistList] |
List of services and assigned providers |
[CancellationKeyword] |
SMS keyword the guest can text to cancel (in SMS templates) |
[BookingURL] |
Online booking URL for rescheduling |
Note:
[CancellationKeyword]is only available in SMS cancellation templates.[ConfirmLink]and[FeedbackLink]are not available in cancellation templates.
Appointment reschedule macros
These macros are available in the appointment reschedule notification template. Use them when an appointment is rescheduled to a new date or time.
| Macro | Description |
|---|---|
[AppDate] |
New appointment date |
[StartTime] |
New start time |
[EndTime] |
New end time |
[OrigStartTime] |
Original start time before the reschedule |
[Duration] |
Appointment duration |
[ServiceTherapistList] |
List of services and assigned providers |
[ServiceTherapistTimeList] |
List of services, providers, and scheduled times |
[RescheduleLink] |
Link for the guest to reschedule again |
[ConfirmLink] |
Link for the guest to confirm the rescheduled appointment |
[BookingURL] |
Online booking URL |
[ServiceNameVideoLinkList] |
Zoom meeting link Zenoti creates, listed with each virtual service's name. Inserted as message text β see Virtual appointment link macros. |
[EmailVirtualAppointmentLink] |
Virtual appointment link for email templates (the link staff add by hand) |
[SMSVirtualAppointmentLink] |
Virtual appointment link for SMS templates (the link staff add by hand) |
Note:
[OrigStartTime]is only available in reschedule templates. Inserting it into a confirmation or cancellation template will produce a blank value.
First appointment reminder macros
These macros are available in the First Appointment Reminder notification template (template ID 7). The First Reminder fires at the earlier of the two configurable reminder windows before an upcoming appointment.
| Macro | Description |
|---|---|
[AppDate] |
Appointment date |
[StartTime] |
Appointment start time |
[EndTime] |
Appointment end time |
[Duration] |
Appointment duration |
[ServiceTherapistList] |
List of services and assigned providers |
[ServiceTherapistTimeList] |
List of services, providers, and scheduled times |
[ConfirmLink] |
Link for the guest to confirm the appointment |
[CancellationKeyword] |
SMS keyword the guest can text to cancel |
[BookingURL] |
Online booking URL |
[UpcomingAppointment] |
Next upcoming appointment details |
[ServiceNameVideoLinkList] |
Zoom meeting link Zenoti creates, listed with each virtual service's name. Inserted as message text β see Virtual appointment link macros. |
[EmailVirtualAppointmentLink] |
Virtual appointment link for email templates (the link staff add by hand) |
[SMSVirtualAppointmentLink] |
Virtual appointment link for SMS templates (the link staff add by hand) |
Second appointment reminder macros
These macros are available in the Second Appointment Reminder notification template (template ID 129). The Second Reminder fires at the later configurable reminder window β typically closer to the appointment time β and is a separate template from the First Reminder. You configure the Second Reminder's send time, channel mix, and content independently of the First Reminder.
| Macro | Description |
|---|---|
[AppDate] |
Appointment date |
[StartTime] |
Appointment start time |
[EndTime] |
Appointment end time |
[Duration] |
Appointment duration |
[ServiceTherapistList] |
List of services and assigned providers |
[ServiceTherapistTimeList] |
List of services, providers, and scheduled times |
[ConfirmLink] |
Link for the guest to confirm the appointment |
[CancellationKeyword] |
SMS keyword the guest can text to cancel |
[BookingURL] |
Online booking URL |
[HoursUntilAppointment] |
Hours remaining until the appointment starts |
[ServiceNameVideoLinkList] |
Zoom meeting link Zenoti creates, listed with each virtual service's name. Inserted as message text β see Virtual appointment link macros. |
[EmailVirtualAppointmentLink] |
Virtual appointment link for email templates (the link staff add by hand) |
[SMSVirtualAppointmentLink] |
Virtual appointment link for SMS templates (the link staff add by hand) |
Note: The First and Second Reminder templates are two distinct templates in Zenoti. Configure each one separately β send time, channel toggles (Email / SMS / WhatsApp / Push), and message text are all independent. That includes the virtual meeting link: adding a link macro to the First Reminder does not place it in the Second Reminder.
Appointment no-show macros
These macros are available in the Appointment No Show notification template (template IDs 261, 262, 263, 962, 963, 964; notification type ID 176). This template fires when an appointment is marked as no-show, and may be sent to the guest, to an employee, or to both depending on your configuration.
| Macro | Description |
|---|---|
[AppDate] |
Appointment date that was missed |
[StartTime] |
Scheduled start time |
[ServiceTherapistList] |
Services that were scheduled |
[NoShowFee] |
No-show fee charged (if a cancellation policy is in effect) |
[BookingURL] |
Online booking URL for rebooking |
Note: No-show notifications are not sent automatically when an appointment status is changed to No-Show β the template must be enabled for the relevant recipient role. Use the employee-directed variant to alert providers or managers; use the guest-directed variant to contact the guest (for example, to reference a no-show fee).
Appointment completion to guest macros
These macros are available in the Appointment Completion to Guest notification template (template IDs 125, 281). This template fires when an appointment is marked complete and is distinct from the Thank You template described in the next section. Use this template when you want a completion-confirmation message β for example, one that includes a feedback link or rebooking invitation.
| Macro | Description |
|---|---|
[AppDate] |
Appointment date |
[StartTime] |
Appointment start time |
[ServiceTherapistList] |
Services delivered |
[FeedbackLink] |
Post-appointment feedback link |
[ConfirmLink] |
Confirmation link |
[BookingURL] |
Online booking URL for rebooking |
[SubmittedFormCopy] |
Link to the guest's submitted form, when the form-level Email copy of the form to guest on submission setting is on and the submission qualifies β see the note on this macro in Why a macro renders empty. |
Note:
[FeedbackLink]is only available in the Appointment Completion to Guest and Thank You templates. It is not available in confirmation, cancellation, or reminder templates.
Thank you macros
These macros are available in the Thank You notification template (template ID 24). This is a separate template from Appointment Completion to Guest β use Thank You when you want a dedicated post-service or post-visit touchpoint, such as a simple gratitude message without a feedback request or with different wording than the completion confirmation.
| Macro | Description |
|---|---|
[AppDate] |
Appointment date (if applicable) |
[ServiceTherapistList] |
Services delivered |
[TotalPayment] |
Amount the guest paid (if tied to an invoice) |
[BookingURL] |
Online booking URL |
Note: The Do not send Thank You message for non-service purchases setting on the Email / Text page under Configuration > Notifications is a separate control β when it is on, Zenoti skips the Thank You message for product-only and other non-service invoices. The Thank You template itself covers both service and non-service contexts when the setting is off.
Note:
[SubmittedFormCopy]also resolves in the Thank You template under the same conditions as the Appointment Completion to Guest template, but it is not offered in this template's macro picker β add it by typing the macro name directly.
Invoice and payment macros
These macros are available in invoice, receipt, and payment-related notification templates. The invoice-close templates fire when an invoice is finalized; the separate Payment Made template (see the next section) fires when a payment is recorded against an existing invoice.
| Macro | Description |
|---|---|
[InvoiceNo] |
Invoice number |
[InvoicePrice] |
Invoice subtotal |
[InvoiceTotal] |
Invoice total including tax and fees |
[AmountPaid] |
Amount the guest paid |
[DueAmount] |
Outstanding balance |
[TotalPayment] |
Total payment made |
[TipAmount] |
Tip amount |
[InvoiceDue] |
Invoice due date |
[ReceiptNo] |
Receipt number |
[ProductList] |
List of purchased products |
[GuestPaymentLink] |
Payment link for the guest to pay online. Depends on a setting being on β see the note below this table. |
[DefaultPaymentMethod] |
Guest default payment method |
[CardLast4Digits] |
Last 4 digits of the card on file |
[CollectionDate] |
Recurring collection date |
Note:
[GuestPaymentLink]resolves only when Enable auto trigger of payment link when membership payment collection fails during dunning is on under Payment links. The macro is offered in the macro list whether or not that setting is on, so a template can be saved and activated and still send an empty payment link. This macro also supplies a complete address on its own β insert it with the link address left unmodified, as described in Macros inside links.
Payment made macros
These macros are available in the Payment Made notification template (template IDs 69, 284). This is a distinct template from the invoice-close receipt β it fires when a payment is recorded against an existing invoice (for example, a partial payment on a payment plan, or a late payment applied to an outstanding balance).
| Macro | Description |
|---|---|
[InvoiceNo] |
Invoice number the payment was applied to |
[AmountPaid] |
Amount paid in this transaction |
[TotalPayment] |
Cumulative payment total against the invoice |
[DueAmount] |
Remaining balance after this payment |
[DefaultPaymentMethod] |
Payment method used |
[CardLast4Digits] |
Last 4 digits of the card on file (card payments) |
[CollectionDate] |
Date the payment was recorded |
Note: The Payment Made template is separate from the invoice-close receipt. Configure the receipt template for end-of-transaction confirmation; use the Payment Made template to acknowledge subsequent payments against open invoices.
Receipt header and footer macros
These macros are available in the Customer Email Receipt Header and Customer Email Receipt Footer notification templates. The two templates control the block of content that sits above and below the receipt body. They render on printed receipts as well as emailed ones, so a change you make to either template reaches both outputs β review the printed form before you activate a change intended only for email.
Receipt and invoice identity
These macros carry the identifiers and timestamps that label the receipt.
| Macro | Description |
|---|---|
[ReceiptNo] |
Receipt number |
[InvoiceNo] |
Invoice number |
[TaxInvoiceNumber] |
Tax invoice number |
[InvoiceSequence] |
Invoice sequence number |
[InvoiceCloseDate] |
Date the invoice was closed |
[InvoiceCloseTime] |
Time the invoice was closed |
[TransactionType] |
Type of transaction the receipt records |
[ReceiptCopy] |
Marks the receipt as a copy rather than the original |
[ReceiptCopyNumber] |
Number of the receipt copy |
[ReprintDate] |
Date the receipt was reprinted |
[ReprintTime] |
Time the receipt was reprinted |
[PrintDateAndTime] |
Date and time the receipt was printed |
[LineCount] |
Number of line items on the receipt |
[SalesTotal] |
Total sales amount on the receipt |
Organization and center
These macros resolve to the identity and contact details of the center that issued the receipt.
| Macro | Description |
|---|---|
[OrgName] |
Organization name |
[CenterName] |
Center name |
[CenterAddress] |
Center street address |
[CenterCity] |
Center city |
[CenterState] |
Center state or province |
[CenterZip] |
Center postal code |
[CenterCountry] |
Center country |
[CenterPhone] |
Center primary phone number |
[CenterPhone2] |
Center secondary phone number |
[CenterE-mail] |
Center email address |
[CenterAddlData1] |
The center's Enter additional text value |
[LogoURL] |
Address of the logo image shown on the receipt |
Note:
[CenterAddlData1]inserts whatever has been entered in the center's Enter additional text field. Use it to carry a line of center-specific text β opening hours or a returns note, for example β into the header or footer without maintaining a separate template for each center.
Tax registration
These macros carry the center's tax registration numbers and the tax header text.
| Macro | Description |
|---|---|
[TIN] |
Taxpayer identification number |
[CST] |
Central sales tax registration number |
[VAT] |
VAT registration number |
[ServiceTax] |
Service tax registration number |
[LuxuryTax] |
Luxury tax registration number |
[TaxHeader] |
Tax header text configured for the center |
The following four macros appear in the macro list only while Enable India GST is on. Turning that setting off removes them from the list; a template that already contains one will send it blank.
| Macro | Description |
|---|---|
[GSTIN] |
GST identification number |
[StateCode] |
GST state code |
[CenterPAN] |
Center PAN |
[InvoiceQRCode] |
QR code printed on the invoice |
Guest and service
These macros resolve to guest profile values and to details of the items on the invoice.
| Macro | Description |
|---|---|
[GuestIdentification] |
Guest identification recorded on the profile |
[GuestAdditionalDetails1] |
Guest additional detail 1 |
[GuestAdditionalDetails2] |
Guest additional detail 2 |
[ServiceAddlData1] |
Service additional data 1 |
[ServiceAddlData2] |
Service additional data 2 |
[UpcomingAppointment] |
Guest's next upcoming appointment |
[TreatmentList] |
List of treatments on the invoice |
[JobText] |
Job-level text configured for the service |
[AppCost] |
Appointment cost |
[UserMembershipCode] |
Membership code held by the guest |
Register
These macros identify the cash register the invoice was closed on.
| Macro | Description |
|---|---|
[RegisterName] |
Name of the cash register |
[RegisterOperator] |
Employee operating the register |
[RegisterID] |
Register identifier |
Country fiscal fields
Receipts in some countries must carry a fiscalization block. These macros supply those values; which of them your receipts need depends on the country the center operates in.
| Macro | Description |
|---|---|
[IKOF] |
Fiscal identifier issued for the receipt |
[JIKR] |
Fiscal invoice identifier issued for the receipt |
[SequentialNumber] |
Sequential number assigned to the receipt |
[SoftwareVersion] |
Version of the software that issued the receipt |
[DigitalSignature] |
Digital signature applied to the receipt |
[CashRegisterCode] |
Code identifying the cash register that issued the receipt |
Membership lifecycle macros
These macros are available in membership notification templates (signup, renewal, upgrade, downgrade, freeze, cancel, anniversary, and collection reminders).
| Macro | Description |
|---|---|
[MembershipName] |
Membership name |
[MembershipFee] |
Membership fee amount |
[MembershipStartDate] |
Membership start date |
[MembershipExpiryDate] |
Membership expiry date |
[MembershipBenefits] |
List of membership benefits |
[FreezeStartDate] |
Freeze start date |
[FreezeEndDate] |
Freeze end date |
[CancelDate] |
Cancellation date |
[CancelFee] |
Cancellation fee |
[UpgradeTo] |
Name of the membership being upgraded to |
[DowngradeTo] |
Name of the membership being downgraded to |
[TransferTo] |
Name of the member the membership is transferred to |
[NumberOfAnniversaryYears] |
Number of anniversary years |
Package macros
These macros are available in package notification templates (purchase confirmation, redemption notices, expiry reminders).
| Macro | Description |
|---|---|
[PackName] |
Package name |
[PackRemBenefits] |
Remaining package benefits |
[ListOfRedeemableServices] |
List of services redeemable under the package |
[Price] |
Package price |
[ExpiryDate] |
Package expiry date |
[Visits] |
Number of visits remaining |
[ReminderDays] |
Days until expiry reminder |
Gift card macros
These macros are available in the general gift card notification templates β the non-POS context, covering purchase confirmation (online or email-delivered), balance updates, and expiry reminders.
| Macro | Description |
|---|---|
[GiftCredit#] |
Gift card number |
[GiftCreditValue] |
Gift card value |
[GiftCreditExpiry] |
Gift card expiry date |
[GCBalance] |
Current gift card balance |
[GCUsage] |
Gift card usage details |
Gift card POS macros
These macros are available in the Gift Card POS notification templates (template IDs 86, 736β744). This is the POS-context template set that fires when a gift card is sold or redeemed at the point of sale β for example, a transactional receipt for a gift card purchase or a confirmation that a gift card was applied to an invoice. The POS context uses additional macros not available in the general gift card templates, because the POS transaction exposes barcode and redemption-specific information.
| Macro | Description |
|---|---|
[GiftCredit#] |
Gift card number |
[GiftCreditValue] |
Gift card face value |
[GCBalance] |
Remaining balance after the POS transaction |
[BarCode] |
Gift card barcode (printed on POS receipt) |
[InvoiceNo] |
POS invoice number the gift card was applied to |
[AmountPaid] |
Amount paid via gift card in this transaction |
Note: Use the Gift Card POS templates for invoices generated at the point of sale β they include barcode and invoice-linking macros that the general gift card templates do not. The general gift card templates apply when the card is purchased online, sent by email, or updated outside a POS session.
Loyalty macros
These macros are available in loyalty point notification templates (accrual, redemption, expiry, tier change).
| Macro | Description |
|---|---|
[LoyaltyProgramName] |
Loyalty program name (name of the loyalty points promotion applied). |
[LoyaltyAccrued] |
Points accrued in the transaction |
[LoyaltyBalance] |
Current loyalty points balance |
[LoyaltyRedeemed] |
Points redeemed in the transaction |
[LPExpiring] |
Points about to expire |
[LPExpiryDate] |
Date when points expire |
[CurrentLPTier] |
Guest's current loyalty tier |
Note: The correct macro is
[LoyaltyProgramName]β the natural spelling, with no extra letter. It resolves to the name of the loyalty points promotion applied. Do not insert a misspelled variant with an extra letter between "Program" and "Name".
Employee notification macros
These macros are available in employee notification templates (credentials, password reset, password change).
| Macro | Description |
|---|---|
[UserName] |
Login username |
[Password] |
Temporary password (used in initial credentials notifications) |
[ResetPasswordLink] |
Password reset link |
Inventory notification macros
These macros are available in inventory-related notifications such as transfer order emails and vendor invoice notifications.
| Macro | Description |
|---|---|
{TransferOrderNumber} |
Transfer order reference number |
{FromCenter} |
Center sending the transfer |
{ToCenter} |
Center receiving the transfer |
{ProductName} |
Product name in the transfer or invoice |
{Quantity} |
Quantity of items |
{VendorName} |
Vendor name for purchase orders |
{InvoiceNumber} |
Vendor invoice reference number |
Queue and kiosk notification macros
These macros are available in queue check-in and kiosk wait-time notifications.
Queue macros
| Macro | Description |
|---|---|
{QueuePosition} |
Guest's current position in the queue |
{EstimatedWaitTime} |
Estimated wait time in minutes |
{ServiceName} |
Name of the service the guest is waiting for |
{ProviderName} |
Name of the assigned service provider |
Kiosk macros
| Macro | Description |
|---|---|
{KioskName} |
Name of the kiosk device |
{CheckInTime} |
Time the guest checked in |
{QueuePosition} |
Guest's position in the queue |
{WaitTime} |
Estimated wait time |
{ThresholdMinutes} |
Configured wait time threshold |
Authentication and link macros
These macros are available in authentication-related templates (OTP verification, opt-in/opt-out, unsubscribe).
| Macro | Description |
|---|---|
[OTP] |
One-time password for verification |
[Opt-InLink] |
Communication opt-in link |
[Opt-OutLink] |
Communication opt-out link |
[Opt-InKeywords] |
SMS opt-in keywords (for example, YES or START) |
[Opt-OutKeyword] |
SMS opt-out keyword (for example, STOP) |
[MailUnsubscribeLink] |
Email unsubscribe link |
[WhatsAppConsent] |
WhatsApp consent link |
Used in WhatsApp templates. See Configure WhatsApp notification templates for the template-side configuration that uses this macro.
Note:
[Opt-InLink],[Opt-OutLink], and[MailUnsubscribeLink]each supply a complete address. Insert them with the link address left unmodified, as described in Macros inside links.
Custom macros
Custom macros allow you to insert organization-specific or center-specific values into any template.
| Macro | Description |
|---|---|
[CustomMacros1] |
Organization custom macro 1 |
[CustomMacros2] |
Organization custom macro 2 |
[EntityCustomAttribute1] through [EntityCustomAttribute4] |
Custom entity attributes configured at the organization or center level |
Custom macros are managed at both the organization and center levels. Contact your Zenoti administrator to configure custom macro values.
Referral macros
These macros are available in refer-a-friend notification templates.
| Macro | Description |
|---|---|
[ReferredGuestFirstName] |
Referred guest first name |
[ReferredGuestLastName] |
Referred guest last name |
[ReferrerGuestFirstName] |
Referring guest first name |
[ReferrerGuestLastName] |
Referring guest last name |
Push notification macros
These macros are available in push notification templates delivered through the Zenoti mobile apps (guest-facing, employee-facing, and Zenoti Go). Push templates support a smaller set of macros than email or text templates because the mobile device platforms impose strict payload-size limits. The macros below are grouped by template family.
Class push macros
Used in class-related push notifications (class booking, class cancellation, class reminder, class roster updates).
| Macro | Description | Available in templates |
|---|---|---|
[ClassName] |
Name of the class | Class booking, class cancellation, class reminder |
[Instructor] |
Assigned class instructor | Class booking, class reminder, class roster |
[OldInstructor] |
Previous class instructor (when an instructor change occurs) | Instructor change |
[NewInstructor] |
Newly assigned class instructor | Instructor change |
[ClassCost] |
Cost of the class | Class booking |
[ClassDate] |
Date the class is scheduled | Class booking, class reminder |
[DayOfClass] |
Day of week the class falls on | Class reminder |
[ClassesVirtualLink] |
Virtual class join link (for online classes) | Class booking, class reminder |
[Duration] |
Duration of the class | Class booking, class reminder |
Workshop push macros
Used in workshop-related push notifications (workshop booking, workshop reminder, session lifecycle).
| Macro | Description | Available in templates |
|---|---|---|
[SessionName] |
Workshop session name | Workshop booking, workshop reminder |
[SessionDate] |
Workshop session date | Workshop booking, workshop reminder |
[ExpiryTime] |
Time at which a pending booking request expires | Workshop request, class request |
Membership push macros
Used in membership-related push notifications (membership awards, request status).
| Macro | Description | Available in templates |
|---|---|---|
[AwardName] |
Name of the membership award or benefit granted | Membership award |
[RequestStatus] |
Status of a guest-initiated request (for example, approved, declined) | Membership request, booking request |
Employee push macros
Used in employee-facing push notifications (shift reminders, schedule changes, guest-count alerts).
| Macro | Description | Available in templates |
|---|---|---|
[ShiftStartTime] |
Scheduled start time of the employee's shift | Shift reminder, schedule change |
[ShiftEndTime] |
Scheduled end time of the employee's shift | Shift reminder, schedule change |
[GuestCount] |
Total guests scheduled for the day | Daily schedule, shift reminder |
[GuestRequestCount] |
Number of pending guest requests assigned to the employee | Request alert |
[NewGuestCount] |
Number of new guests added since the last alert | Daily schedule update |
[NextService] |
Name of the next service in the employee's schedule | Next-service alert |
[NextServiceStartTime] |
Start time of the next service in the schedule | Next-service alert |
Zenoti Go push macros
Used in Zenoti Go (guest mobile app) push notifications.
| Macro | Description | Available in templates |
|---|---|---|
[ClassName] |
Name of the class booked through Zenoti Go | Zenoti Go class booking, Zenoti Go class reminder |
[Instructor] |
Class instructor | Zenoti Go class booking, Zenoti Go class reminder |
[ClassDate] |
Date of the booked class | Zenoti Go class booking, Zenoti Go class reminder |
[ClassesVirtualLink] |
Virtual class link (for online classes) | Zenoti Go class booking |
Note: Push notification macros are constrained by the payload size limits that the Android and iOS platforms set for push messages. Keep push templates short and avoid stacking many macros in a single template β long expanded values are truncated by the device platform before display.
Tips
- Insert macros from the Available Macros list in the template editor rather than typing them manually to avoid typos.
- The editor shows only the macros that are valid for the selected notification type. If a macro does not appear in the editor, it is not supported for that template.
- The editor does not filter the macro list by setting. Before you activate a template that uses
[GuestPaymentLink], confirm that Enable auto trigger of payment link when membership payment collection fails during dunning is on under Payment links. - When you add a virtual meeting link, work through every template the guest will receive β confirmation, online-booking confirmation, both reminders, the reschedule notice, and the group confirmations. A link macro added to one of them does not carry into the others.
- Test your templates using the preview feature to verify that macros resolve correctly before activating the template.
- Changes to the Customer Email Receipt Header and Customer Email Receipt Footer templates affect printed receipts as well as emailed ones. Print a test receipt after editing either template.
- For SMS templates, keep your message concise. Each macro resolves to actual values that count toward the SMS character limit.
- The
[CustName]macro combines first and last name. Use[FirstName]and[LastName]separately if you need more control over formatting. - If a macro arrives blank, check first whether the notification type supports it, then whether it depends on a setting. Neither condition raises an error when you save the template.
- For a link whose address carries a macro, choose the option that leaves the address unmodified, then confirm the result with Send Test Email and click the link in the message you receive.