Expressions
Expressions allow you to define dynamic values in your template.
They are used to:
- insert data into the document
- transform values
- perform calculations
- control formatting
Expressions are used throughout the template editor — for example in text, form fields, dynamic images, and file names.
How it works
An expression combines different elements:
- values (numbers or text)
- variables (input data)
- operators (e.g.
+,>) - functions (e.g.
CONCAT,DATE)
Example:
CONCAT("Hello ", name)
This expression combines static text with a variable.
Variables
Variables represent input data.
Examples:
Name
email
UnitPrice
order_number
You can also access nested data using dot notation:
Address.City
Numbers
Numbers use a simple format:
123
123.456
The decimal part is optional.
Operators
Operators allow you to perform calculations and comparisons.
Examples:
quantity * price
price > 50
Functions
Functions allow you to transform and format data.
Examples:
CONCAT("INV", NUM(invoiceNumber, 4))
DATE(TODAY(), "yyyy-MM-dd")
Types
Expressions support different data types:
- string
- number
- boolean
- date
- array
The type is automatically inferred based on how the value is used.
Example:
A + 3
This forces A to be treated as a number.
When to use Expressions
Use expressions when you need to:
- combine values
- format numbers or dates
- generate dynamic text
- derive new values from input data
Related topics
- Full reference → Data Expressions