Working with placeholders
A placeholder is a section of text that is placed in a document, temporarily until the final text is inserted there at a later stage.
In our context, placeholders are there to identify variables (name, email, etc …) mainly in email templates but sometimes also elsewhere. In all cases, the available placeholders are always specified when they can be used.
How to use placeholders?
For example, let’s say you to start your template with Hello followed by the name of your customer.
Just write as below and leave your cursor one blank space after Hello.
Then click on Customer name, this will automatically insert your placeholder in the right place.
It’s as simple as that. All you have to do is save your template.
Custom fields as placeholders
Since version 3.1.7, you can use custom fields as placeholders in your email templates and in Setting > Email notifications. The principle is simple, you take the id of your custom field (eg id: custom-field1) and paste it to #field_.
#field_custom-field1 will be identified as any other placeholder available in your editor.
Message placeholders
Service name
#service_name
The name of the service you want to display.
Category name
#current_category_name
Represents the category selected by a customer.
Category names
#category_names
Shows all the categories to which service belong.
Customer name
#customer_name
The name of your customer.
Booking date
#appointment_day
The selected date of the booking.
Booking time
#appointment_time
The selected time of the booking.
Booking local date
#appointment_local_date
Displays the selected booking date converted to the customer’s time zone.
Booking local time
#appointment_local_time
Displays the selected booking time converted to the customer’s time zone.
Appointment ID
#appointment_id
Displays the identification number of the customer’s reservation.
Customer phone
#customer_phone
Displays the phone number of your customer.
Customer email
#customer_email
Displays the email of your customer.
Customer comment
#customer_comment
Displays the comment left from your customer.
Custom data
#customer_custom
Displays the custom data you defined using custom fields.
Items count
#items_count
Selected count
#selected_count
Displays the count of time slots booked in Multiple mode
Displays the number of items/places reserved.
Total amount
#total_amount
The total amount to pay for your customer.
Payment link
#payment_link
The link to direct your customer to the payment page.
Cancel link
#cancel_link
The link to allow your customer the cancellation of his booking.
Agenda for tomorrow
#tomorrow_agenda
Displays all the bookings for the next day. Convenient for the administrator or staff.
Group customer name
#group_customer_name
List of the customers concerned by the booking.
Create loop
[appointment_loop_start][appointment_loop_end]
To use in case you allow multiple booking in one session. Put the date and time in between.
Administrator cancel link
#admin_cancel_link
In case you want to cancel your customer booking. To use in administrator email notification. It may be more convenient in some case.
Administrator approval link
#admin_approve_link
In case you want to approve manually your customer booking. To use in administrator email notification. It may be more convenient in some case.
Customer Google calendar link
#add_event_link
This link will automatically create an event into the Google calendar from your customer.
Booking time range
#time_range
In case you want to display in start-end format the time of the booking.
Time range
#timerange
Only available with ‘Multiple bookings in one session’ enabled.
The time range placeholder would contain11:00 am – 3:00 pm if you would have selected the range of time slots from 11:00 am to 3:00 pm.
Time date range
#timedaterange
Only available with ‘Multiple bookings in one session’ enabled.
The time range placeholder would containMay 1, 2019 11:00 am – May 1, 2019 3:00 pm if you would have selected the range of time slots from 11:00 am to 3:00 pm.
Duration
#duration
Displays the time allocated to the reservation.
Subject placeholders
These are the placeholders you can use in your emails subjects.
Service name
#service_name
The name of the service you want to display.
Category names
#category_names
The name of the category you want to display.
Customer name
#customer_name
The name of your customer.
Booking date
#appointment_day
The selected date of the booking.
Booking time
#appointment_time
The selected time of the booking.
Booking local date
#appointment_local_date
Displays the selected booking date converted to the customer’s time zone.
Booking local time
#appointment_local_time
Displays the selected booking time converted to the customer’s time zone.
Appointment ID
#appointment_id
Displays the identification number of the customer’s reservation.
Customer phone
#customer_phone
Displays the phone number of your customer.
Customer email
#customer_email
Displays the email of your customer.
Customer comment
#customer_comment
Displays the comment left from your customer.
Custom data
#customer_custom
Displays the custom data you defined using custom fields.
Items count
#items_count
Displays the number of items/places reserved.
Total amount
#total_amount
The total amount to pay by your customer.
Group customer name
#group_customer_name
List of the customers concerned by the booking.
Create loop
[appointment_loop_start][appointment_loop_end]
To use in case you allow multiple booking in one session. Put the date and time in between.
Booking time range
#time_range
In case you want to display in start-end format the time of the booking.
Placeholders for price
#subtotal_amount
Show the price before tax
#tax_amount
Show how the amount of is tax in price
#one_slot_price
Price of one slot
#status
The status of appointment
Example:
For a price of $200 and tax of 10: #subtotal_amount will show $200 and #tax_amount will show $20.