Skip to main content
Variables let you insert dynamic content into your documents. They are replaced with actual values at render time.

​
Inline variables

Reference variables inline with double curly braces: 
Dear {{customer.name}}, your order #{{order.id}} is ready.
The total amount is {{totalAmount}} EUR.
Variable names must start with a letter and can contain letters, numbers, and underscores. Dot notation (customer.name) is supported for nested values.

​
Block-level variables

Place a variable reference on its own line to render it as a standalone block: 
{{companyLogo}}
{{signatureBlock}}
{{footerContent}}
Block-level variables can contain images, text blocks, or other complex content defined in your document’s variable configuration.

​
Variable types

Variables support multiple types. The type is determined by the value you provide:
  • Text — A simple string value (e.g., "companyName": "Acme Inc")
  • Number — A numeric value (e.g., "total": { "type": "number", "value": 1250.00 })
  • Image — An image with optional dimensions and alignment
  • List — An ordered or unordered list
  • Table — A 2D data table with optional column headers
Number variables are rendered as text when used inline ({{total}} becomes "1250"). They are especially useful in chart dataset data arrays, where they are automatically resolved to numeric values.
For full details on defining each variable type, see the JSON Syntax — Variables reference.

​
Built-in variables (headers & footers)

These variables are automatically available in document headers and footers:
VariableDescriptionExample Output
{{pageNumber}}Current page number1
{{totalPages}}Total page count99
{{date}}Current date (DD.MM.YYYY)02.02.2026

​
Date variable formatting

The {{date}} variable supports custom formatting, date manipulation, and timezone offsets.

​
Syntax

{{date}}                          → Default format (DD.MM.YYYY)
{{date/FORMAT}}                   → Custom format
{{date/FORMAT/OFFSET}}            → With date manipulation
{{date/FORMAT/OFFSET/TIMEZONE}}   → With timezone offset

​
Format tokens

TokenDescriptionExample
YYYY4-digit year2026
YY2-digit year26
MMMMFull month nameFebruary
MMMShort month nameFeb
MM2-digit month02
M1-2 digit month2
ddddFull weekdaySunday
dddShort weekdaySun
DD2-digit day02
D1-2 digit day2
HH24-hour hour14
mmMinutes35

​
Format presets

Instead of building a format string, use a preset name:
PresetEquivalent FormatExample
isoYYYY-MM-DD2026-02-02
timeHH:mm14:35
datetimeDD.MM.YYYY HH:mm02.02.2026 14:35
longD. MMMM YYYY2. February 2026
monthYearMMMM YYYYFebruary 2026

​
Date offset (manipulation)

Shift the date forward or backward:
OffsetDescription
+1dTomorrow
-7d7 days ago
+1mNext month
-1yLast year
+2h2 hours from now
+30min30 minutes from now

​
Timezone offset

Specify a UTC offset in +HH:mm or -HH:mm format: 
{{date/HH:mm//+01:00}}           → Time in CET
{{date/datetime/+7d/+02:00}}     → Next week, CEST
When using a timezone offset without a date offset, leave the offset slot empty with double slashes: {{date/FORMAT//TIMEZONE}}.

​
Examples

{{date/DD.MM.YYYY}}              → 02.02.2026
{{date/YYYY-MM-DD}}              → 2026-02-02
{{date/D. MMMM YYYY}}           → 2. February 2026
{{date/iso}}                     → 2026-02-02
{{date/DD.MM.YYYY/+1d}}         → Tomorrow's date
{{date/MMMM YYYY/-1y}}          → February 2025
{{date/HH:mm//+01:00}}          → Time in CET
{{date/datetime/+7d/+02:00}}    → Next week, CEST