Skip to main content

Keywords

Communication Settings: Keywords

Written by Max Sturley

What Are Keywords?

Keywords are dynamic placeholders used inside WaitWell communication templates — including SMS messages, emails, lobby screen messages, kiosk confirmations, and web page content. When a template is triggered, each keyword is automatically replaced with real, context-specific data pulled from the active ticket, appointment, queue, or location.

For example, adding {{Name}} to a template will automatically display the customer's full name when the message is sent. Similarly, {{QueuePosition}} will show the customer their current place in line at the moment the communication is delivered.

How to Use a Keyword

There are three ways to add a keyword to a template:

1. Insert Keyword Button: In the configuration window for basic and rich templates, position your cursor where you want the keyword to appear in the message, then select the Insert Keyword button. Select the keyword from the list and it will be placed automatically at your cursor position.

2. Type it Directly: Manually type the keyword, including the double curly braces on both sides, directly into the template body (e.g., {{Name}}). Keywords are case-sensitive and must exactly match the format shown in the glossary below.

3. Copy and Paste: Copy a keyword from this glossary or another source and paste it into the template body.

⚠️ Important — Template Availability: Not all keywords are available in every communication template. Keywords are grouped by context in the table below. Using a keyword that is listed for one template type but not another will not work and will not populate when the template is triggered.

Keyword & Function Matrix

Customer & Ticket Keywords

Keyword

Function

{{Name}}

Displays the customer's full first name.

{{FirstInitial}}

Displays the first initial of the customer's first name.

{{LastInitial}}

Displays the first initial of the customer's last name.

{{LastName}}

Displays the customer's last name.

{{ServiceType}}

Displays the name of the service type the customer selected.

{{ServiceTypeID}}

Displays the unique system ID assigned to the service type.

{{ServiceTypeDetails}}

Displays additional details or description associated with the selected service type. Note: This content can be found and updated in the Service Type Settings.

{{ServiceTypeWaiver}}

Displays waiver information associated with the selected service type.

{{MeetMethod}}

Displays the method by which the customer will be served (e.g., In-Person, Virtual, Phone).

{{QueueName}}

Displays the name of the queue the customer has joined.

{{ClientSiteLink}}

Inserts a direct link to the client-facing WaitWell portal for the location.

{{WebStatusLink}}

Inserts a link to the customer's web-based ticket status page.

{{QRCode}}

Inserts a QR code that can be scanned to access the customer's ticket or status page.

{{WaiverLink_1}}

Inserts a unique link to a Waiver/Form associated with the service. Each additional waiver created generates its own unique keyword that increments numerically (e.g., {{WaiverLink_2}}, {{WaiverLink_3}}).

{{LobbyTicketNumber}}

Displays the ticket number assigned to the customer in the lobby queue.

{{CustomField1}}

Displays the value entered in Custom Field 1 for the service or ticket.

{{CustomField2}}

Displays the value entered in Custom Field 2 for the service or ticket.

{{CustomField3}}

Displays the value entered in Custom Field 3 for the service or ticket.

{{CustomField4}}

Displays the value entered in Custom Field 4 for the service or ticket.

{{CustomField5}}

Displays the value entered in Custom Field 5 for the service or ticket.

{{CustomField6}}

Displays the value entered in Custom Field 6 for the service or ticket.

Location Keywords

Keyword

Function

{{Location.Name}}

Displays the name of the service location.

{{Location.Address}}

Displays the street address of the service location.

{{Location.City}}

Displays the city of the service location.

{{Location.StateProvince}}

Displays the state or province of the service location.

{{Location.PostalZip}}

Displays the postal/ZIP code of the service location.

{{Location.Phone}}

Displays the phone number of the service location.

{{Location.Email}}

Displays the email address associated with the service location.

{{Location.Website}}

Displays the website URL of the service location.

{{Location.CustomKeyword}}

Displays a custom keyword value configured for the location. Note: This value can be edited within the Location Set Up page found in Location Settings.

{{Organization.Name}}

Displays the name of the organization associated with the location.

Queue / Walk-In Keywords (General)

Keyword

Function

{{QueuePosition}}

Displays the customer's current position in the queue.

{{PositionOutside}}

Displays the customer's queue position as visible externally (e.g., on outdoor signage or two-stage waiting).

{{EstimatedWaitTime}}

Displays the estimated wait time for the customer in the queue.

{{EstimatedWaitTime_fr}}

Displays the estimated wait time in French.

{{Desk}}

Displays the name or number of the desk or station assigned to the customer.

{{DeskDescription}}

Displays the description of the desk or station where the customer will be served.

{{StaffFirstName}}

Displays the first name of the staff member serving or assigned to the customer.

{{RateUsLink}}

Inserts a link for the customer to rate or review their experience.

{{AgentName}}

Displays the name of the agent who served the customer.

{{AutoRemoveMinutes}}

Displays the number of minutes before a no-show customer is automatically removed from the queue.

{{OnlineMeetingUrl}}

Displays the URL for joining a virtual/online meeting associated with the ticket.

{{PhoneNumber}}

Displays the phone number on file for the customer's ticket.

{{TicketId}}

Displays the unique system-generated ID for the customer's ticket.

{{TicketNumber}}

Displays the human-readable ticket number assigned to the customer.

Queue / Walk-In Keywords (Feature Specific - Only Enabled When the Related Feature is Enabled)

Keyword

Function

{{MaxPartySize}}

Displays the maximum party size allowed. Used only when 'Ask for Number in Party' is enabled.

{{ServiceTypeSelection}}

Displays the service type selection prompt or options. Used only when 'Choose Service Type' is enabled.

{{QueueSelection}}

Displays the queue selection prompt or options. Used only when multiple queues share the same SMS number and 'Choose Queue' is enabled.

{{NumberWaiting}}

Displays the current number of customers waiting in the queue. Used in Join Page Intro templates.

{{OpenTime}}

Displays the time the location or queue opens. Used in Join Page Intro templates.

{{ClosedTime}}

Displays the time the location or queue closes. Used in Join Page Intro templates.

{{ProgressBarPosition}}

Displays the customer's position as a visual progress bar. Used in the Client Position Progress template.

{{ProgressBarWaitTime}}

Displays the estimated wait time as a visual progress bar. Used in the Client Position Progress template.

{{TimeInStageMins}}

Displays the number of minutes the customer has been in their current stage. Used in the Stage Time Trigger template.

{{StageName}}

Displays the name of the current stage the customer is in. Used in the Stage Time Trigger template.

{{PaymentLink}}

Inserts a link for the customer to complete an online payment. Used in payment-related templates.

{{ProuctsLink}}

Inserts a link to purchasable products or services associated with the ticket. Used in purchase/payment templates.

{{DateTime}}

Displays the current date and time. Used in Kiosk and Print templates.

{{FieldsChangedInfo}}

Displays details about which ticket fields were changed. Used in the Field Changed notification template.

Appointments Keywords

Keyword

Function

{{AppointmentDateTime}}

Displays the scheduled date and time of the appointment.

{{AppointmentDateTime_fr}}

Displays the scheduled date and time of the appointment in French.

{{StartTime}}

Displays the scheduled start time of the appointment.

{{EndTime}}

Displays the scheduled end time of the appointment.

{{DayOfWeek}}

Displays the day of the week for the scheduled appointment (e.g., Monday).

{{StaffName}}

Displays the full name of the staff member assigned to the appointment.

{{StaffFirstName}}

Displays the first name of the staff member assigned to the appointment.

{{StaffEmail}}

Displays the email address of the staff member assigned to the appointment.

{{OnlineMeetingUrl}}

Displays the URL for joining a virtual/online meeting associated with the appointment.

{{RateUsLink}}

Inserts a link for the customer to rate or review their appointment experience.

Staff Scheduling Keywords

Keyword

Function

{{ManagerName}}

Displays the name of the manager who approved or denied the time off request.

{{TimeRange}}

Displays the date/time range affected by the schedule change or time off request.

{{MyTimeOffLink}}

Inserts a link for the staff member to view or manage their time off.

{{MyShiftsLink}}

Inserts a link for the staff member to view their updated shift schedule.

{{AddedShifts}}

Lists the shifts that were added in a schedule change notification.

{{DeletedShifts}}

Lists the shifts that were removed in a schedule change notification.

{{AddedAndDeletedShifts}}

Lists both added and removed shifts together in a schedule change notification.

Staff Notification Keywords

Keyword

Function

{{StaffAppLink}}

Inserts a link to the WaitWell staff application for the notified staff member.

{{TicketsWaitingCount}}

Displays the number of tickets currently waiting in the queue. Used in the Staff People Waiting Notification template.

Visitor Management Keywords

Keyword

Function

{{Card_id}}

Displays the unique ID of the visitor access card used during sign-in or sign-out.

{{CardName}}

Displays the name associated with the visitor access card.

Missing a keyword? If you notice a keyword missing from a template and/or would like a keyword added to a specific template, reach out to your Account Manager to submit a request.

Did this answer your question?