Variables are small lines code that you can place in your email templates, that work by automatically filling up with the subject line of that emails specific customer, order, and products on the order.
Here I have created a manual email template called 'Let us know what you think!', asking my customers after each order to include a review on my website. I have populated it with various email variables; including {{order.number}}, {{customer.name}}
and {{company.name}}
.
Emails are most commonly sent from an individual order itself, like below.
Here you can see that these variables are automatically changed into the order number, the name, and the company name of the individual customer connected to this order.
If you click the button for Preview at the bottom of this pop up box, you can also see what the customer will see when receiving the email in their inbox.
Browse through the variables below to add to your automatic, and manual templates to create the perfect emails for your customers.
Note: Want to know if it is possible to send emails in different languages? Thankfully, it is!
Write your email templates in the language of your choice, and include the same variables that you see below. They will populate using the data from the system in the same way, such as the order number.
In this article:
Order variables
{{order.number}}
{{order.barcode.image}}
{{order.status}}
{{order.startsAt}}
{{order.stopsAt}}
{{order.deposit}}
{{order.depositType}}
{{order.depositValue}}
{{order.discount}}
{{order.discountPercentage}}
{{order.price}}
{{order.grandTotal}}
{{order.totalTax}}
{{order.grandTotalWithTax}}
{{order.totalDiscount}}
{{order.couponCode}}
{{order.couponDiscount}}
{{order.couponPercentage}}
{{order.startLocation.name}}
{{order.startLocation.address}}
{{order.startLocation.addressLine1}}
{{order.startLocation.addressLine2}}
{{order.startLocation.city}}
{{order.startLocation.country}}
{{order.startLocation.zipcode}}
{{order.stopLocation.name}}
{{order.stopLocation.address}}
{{order.stopLocation.addressLine1}}
{{order.stopLocation.addressLine2}}
{{order.stopLocation.city}}
{{order.stopLocation.country}}
{{order.stopLocation.zipcode}}
Note: Currently the variable for {{order.startsAt}}
and {{order.stopsAt}}
cannot be altered. If you change your rental periods to exclude time selection for the customer, the time that will appear here are the default times you set up for each order.
Products and line items
To show information about the products on an order, you need to wrap the variables between {{#order.lines}}
and {{/order.lines}}
. This information is displayed for each product on an order.
For example:
{{#order.lines}}
{{quantity}} x {{title}} | {{displayPrice}}
{{/order.lines}}
Document variables
{{document.name}}
{{document.number}}
{{document.date}}
{{document.deposit}}
{{document.depositHeld}}
{{document.depositPaid}}
{{document.depositRefunded}}
{{document.depositToRefund}}
{{document.paid}}
{{document.due_date}}
{{document.days_until_due}}
{{document.prefix}}
{{document.prefixWithNumber}}
{{document.reference}}
{{document.status}}
{{document.discount}}
{{document.discountPercentage}}
{{document.toBePaid}}
{{document.price}}
{{document.grandTotal}}
{{document.grandTotalWithTax}}
{{document.couponDiscount}}
{{document.totalDiscount}}
Customer variables
Show information about your customers.
{{customer.name}}
{{customer.mainAddress}}
{{customer.avatarUrl}}
{{customer.email}}
{{customer.number}}
{{customer.discountPercentage}}
{{customer.depositType}}
{{customer.depositValue}}
Company variables
These variables display information about your company.
{{company.name}}
{{company.address}}
{{company.addressLine1}}
{{company.addressLine2}}
{{company.city}}
{{company.country}}
{{company.email}}
{{company.financialLine1}}
{{company.financialLine2}}
{{company.phone}}
{{company.zipcode}}
Employee variables
These variables display information about the Booqable user who's sending the email.
{{employee.name}}
{{employee.firstName}}
{{employee.lastName}}
{{employee.avatarUrl}}
{{employee.email}}
Custom field variables
You can use variables in your email templates to quickly populate your emails with the custom fields you may have created for your online checkout, your products, your manual orders, and your customers.
Variables for custom fields have the following structure:
{{context.custom_fields.field_id}}
You'll need to replace the context
and the field_id
to target the correct custom field:
The context can be
order
,customer
, orproduct
.To find the
field_id
, go to Settings > Custom fields and view the specific custom field you wish to include in your emails.
Custom fields for customers, and orders.
Putting it all together, a variable for a customer's address could look like below.
{{customer.custom_fields.contact_address}}
A variable for order packing notes could look like below.
{{order.custom_fields.packing_notes}}
Custom fields for products.
Like other email variables for products, custom fields for products are always added in an order line section. This section renders product lines for all products on an order. It begins with {{#order.lines}}
and ends with {{/order.lines}}
.
Here's an example:
{{#order.lines}}
{{product.custom_fields.tubes_tires}}
{{/order.lines}}