This article lists the placeholders/variables available to you when customizing the layout of the invoice template.
Note on conditional blocks: Placeholders in the form {#has...}{/...} allow conditional display. This means they are only shown if a corresponding value exists.
Important: Please note that upper and lower case must be used exactly as shown for all variables.
Invoice date variables
- {date} Oct 16, 2026
- {dateDay} 18
- {dateMonth} 8
- {dateYear} 2025
- {dateMonthName} August
- {dateMonthNameShort} Aug
- {dateMonthYearDisplay} August 2025
- {dateWithMonthName} 18. August 2025
General invoice information
- {number} Invoice number
- {poNumber} PO number
- {#hasPoNumber}{/hasPoNumber} PO number (conditional, only shown if available)
- {location} Invoice location
- {currentDate} Full date in the format DD.MM.YYYY (e.g., 08.07.2025)
-
{currentDateDay}.{currentDateMonth}.{currentDateYear} (e.g., 8.7.2025)
- {currentDateDay} Day of the month of the current date (e.g., 8)
- {currentDateMonth} Month of the current date (numeric, without leading zero) (e.g., 7)
- {currentDateYear} Four-digit year (e.g., 2025)
- {sender} Name and address of the invoice issuer (multi-line)
- {senderLine} Same as {sender}, but all on one line
- {vatNumber} VAT number
- {receiver} Name and address of the invoice recipient (multi-line).
-
If you want to remove an element from the multi-line placeholder {receiver}, you have to break the variable down into its individual parts and use only the elements you need.
- {#receiverName}{receiverName}{/}: Name
- {receiverAddress}: Address line 1
- {#receiverZip}{receiverZip}{/} {#receiverCity}{receiverCity}{/}: Address line 2
- {#receiverCountry}{receiverCountry}{/}: Country
- {subject} Invoice title
- {description} Invoice text
- {#hasDescription}{/hasDescription} Invoice text (conditional, only shown if available)
- {bankDetails} Payment information (multi-line)
- {dueDate} Due date
- {customDueDate} Due date if custom payment terms were set; otherwise the same as {dueDate}
- {epcreference} QR reference number for QR invoices in Switzerland
- {qr} QR code for the SEPA QR invoice
Project variables
- {projects[0].name} Project name
- {projects[0].notes} Project notes
- {projects[0].referenceNumber} Reference number
- {projects[0].customfield} Custom field at project level (replace "customfield" with the name of the custom field, for example: {projects[0].contactperson})
Within the {#projects}{/projects} block, you can also use the following placeholders to show project-specific information:
- {name} Name & period of the project
- {nameWithNoPeriod} Project name without the period in parentheses. Example: "Project Alpha (1234)" becomes "Project Alpha".
- {total} Total amount of the project
- {referenceNumber} Reference number of the project
- {leaderName} Names of the project leaders (comma-separated)
- {leaderEmail} Email addresses of the project leaders (comma-separated)
- {notes} Notes on the project
- {#hasNotes}{/hasNotes} Notes on the project (conditional, only shown if available)
- {totalCount} Total number of hours or units for the project (formatted with two decimal places)
- {rate} Hourly rate or unit price of the project
- {expensesFlatrate} Label for the expense flat rate, e.g., "Expense flat rate 10%"
- {expensesFlatrateAmount} Amount of the expense flat rate.
- {expensesFlatrateApplyTax} Indicates whether taxes are applied to the expense flat rate
- {expensesFlatrateApplyDiscount} Indicates whether discounts are applied to the expense flat rate
Within the {#entries}{/entries} block, you can use the following additional placeholders to show information per project entry.
- {name} Description of the project entry
- {count} Quantity of the entry
- {rate} Rate of the entry
- {amount} Total amount of the entry
- {countHHMM} Duration of the entry in the format hours:minutes
Advance payments
Within the {#advancePayments}{/advancePayments} block, you can use the following placeholders to show information per advance payment.
- {date} Date of the advance payment (in the format DD.MM.YYYY)
- {amount} Amount of the advance payment
Invoice amounts, taxes and discounts
- {totalBeforeTaxWithoutExpensesFlatRateAmount} Invoice amount before taxes, minus the expense flat rate.
- {totalExpensesFlatRateAmount} Total amount of the expense flat rate
- {discountableAmount} Amount the discount is applied to
- {totalBeforeDiscount} Invoice total before discounts
- {discount} Discount in %
- {#hasDiscount}{/hasDiscount} Discount in % (conditional, only shown if available)
- {discountAmount} Discount amount
- {totalBeforeTax} Invoice total excluding VAT
- {#hasTax}{/hasTax} Tax in % (conditional, only shown if available)
- {tax} Tax in %
- {taxAmount} Tax amount
- {total} Invoice amount including tax and discounts
- {%logo} Company logo
- {currency} Invoice currency
- {text.*} Translated text. Replace "*" with the name of an entry under Settings -> Translations
- {totalCount} Total hours (shows the project total within projects and the grand total outside of projects)
Time ranges & periods
- {yearPeriod} Year of the billing period
- {fromPeriod} Start date of the billing period (in the format DD.MM.YYYY)
- {toPeriod} End date of the billing period (in the format DD.MM.YYYY)
- {fromPeriodWithFirstDayOfMonth} First day of the month of the start date (in the format DD.MM.YYYY)
- {toPeriodWithLastDayOfMonth} Last day of the month of the end date (in the format DD.MM.YYYY)
- {fromPeriodFirstDay} Numeric day (1–31) of the start date
- {toPeriodLastDay} Numeric day (1–31) of the end date
- {fromPeriodFirstMonth} Numeric month (1–12) of the start date
- {toPeriodLastMonth} Numeric month (1–12) of the end date
- {fromPeriodFirstYear} Year of the start date
- {toPeriodLastYear} Year of the end date
- {fromPeriodMonthName} Name of the month of the start date, localized according to the client's language
- {toPeriodMonthName} Name of the month of the end date, localized according to the client's language
- {periodMonthYearDisplay} Formatted period, e.g., "January 2025 – March 2025"
Comments
0 comments
Please sign in to leave a comment.