Days
Hours
Minutes
Seconds
Spring sale:
20% off

Browse the topics:

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.