Variables allow you to insert specific information into printed receipts, tickets or PDF vouchers, enabling greater customisation of customer-facing assets.
Ventrata provides multiple ways to utilise existing variables, and you can also create your own to enhance personalisation.
Variable Types
Variables in Ventrata can be categorised into three levels, each with different degrees of customisation and use cases.
📒 NOTE
Template variables and printing variables do not work with email templates.
1. Static (or Semi-Static) Variables
These variables have fixed keys with little to no customisation. Their notation may vary depending on the platform.
They are all gathered in the following articles:
Printing Variables - used in template editors within the Ventrata dashboard
Sources
Examples
This example uses the notation applicable to printing variables.
Example Variable Key | Printing Variables Notation | Example Value |
Booking reference |
| X12EGA1G |
Product name |
| Techyo Trolley Express |
2. Supplier Level
These variables are specific to your supplier and can be used for translations or standard information across templates.
Sources
template variables added in supplier settings
Examples
Example Variable Key | Notation | Example Value |
entry_point |
| Entry from rear stage door |
product_name |
| PRODUCT NAME |
3. Product, Unit, Tour and Option Variables
These variables provide additional details specific to a product, unit, tour or option. They can also be used as translation keys.
Sources
Examples
Level | Prefix | Example Notation |
|
| |
|
| |
|
| |
|
|
Template & Platforms Usage
Usage | Static (or semi-static) | Supplier Level | Product / Unit / Tour / Option |
Printed Receipts | ✅ YES | ✅ YES | ✅ YES |
✅ YES | ✅ YES | ✅ YES | |
✅ YES | ❌ NO | ❌ NO |
Using Variables in Templates
Prerequisites:
Add global variables to your supplier.
You can use them as translation keys across your templates (except email templates).
Add variables to your products, units, tours and options as necessary to provide additional information for the specific unit, tour or option, respectively.
For multi-language support, make sure that:
Every language you support is listed in Supplier Settings.
Make sure the destination and product have the same default language.
❗️IMPORTANT❗️
Enter variable keys in each language variant in the exact same format, or they will not appear in the final asset.
Voucher Templates
Create your template following the steps outlined here.
Add variables using the Add Textbox button.
📗 TIP
Ensure text fields are large enough to accommodate longer values or translations.
Press Save.
Verify that your variables translate to the correct values by selecting a booking from the bookings table.
Press the Print Voucher.
Select the appropriate template.
Review the template and adjust as needed.
📒 NOTE
Product, unit, tour and option variables must be present on each product to translate into the generated voucher. Notice how the English voucher is missing option and tour instructions.
Voucher Template | English Voucher | Czech Voucher |
 (click on the image to enlarge) |  (click on the image to enlarge) |  (click on the image to enlarge) |
product, unit, tour or option variable
Receipt Templates
Create your template following the steps outlined here.
Add variables using text buttons.
Press Save.
Test the receipt by making a booking on a terminal with a built-in printer or an external printer.
📒 NOTE
Make sure that the Print Tickets option is added to the 'Allowed Delivery Methods' field in the terminal location settings.
Press the Print Ticket button.
Review and adjust the layout as needed.
Receipt Template | English Receipt | Czech Receipt |
| 
| 
|
product, unit, tour or option variable
The delineated area is populated with the receipt template content; the bottom part of the receipt is fixed