Skip to main content

Email Variables

Email templates support a variety of variables that allow you to dynamically insert invoice, client, business, and payment details into your emails. These variables use Liquid templating syntax and are automatically populated when emails are sent.

note

Payment Variables Availability

Payment variables are only available in Payment Confirmation emails, not in New Invoice emails.

Invoice

{{invoice.id}}
The internal ID of the invoice
string
{{invoice.invoice_number}}
The unique number of the invoice generated at send time
string
{{invoice.total_amount}}
The total amount due on the invoice
number
{{invoice.status}}
The current status of the invoice
string
{{invoice.issue_date}}
The date the invoice was issued
date
{{invoice.due_date}}
The date by which the invoice should be paid
date
{{invoice.currency}}
The currency in which the invoice is issued
string
{{invoice.terms}}
The terms and conditions applicable to the invoice
string
{{invoice.footer}}
The footer text displayed on the invoice
string
{{invoice.view_link}}
The URL to view the invoice in the browser
string

Client

{{client.name}}
The name of the client to whom the invoice is issued
string
{{client.email}}
The email address of the client
string
{{client.billing_address_1}}
The first line of the client's address
string
{{client.billing_address_2}}
The second line of the client's address
string
{{client.billing_city}}
The city of the client's address
string
{{client.billing_postcode}}
The postcode of the client's address
string
{{client.billing_country}}
The country of the client's address
string
{{client.shipping_address_1}}
The first line of the client's shipping address
string
{{client.shipping_address_2}}
The second line of the client's shipping address
string
{{client.shipping_city}}
The city of the client's shipping address
string
{{client.shipping_postcode}}
The postcode of the client's shipping address
string
{{client.shipping_country}}
The country of the client's address
string

Business

{{business.name}}
The name of the business issuing the invoice
string
{{business.trading_name}}
The trading name of the business (if different from the official name)
string
{{business.email}}
The email address of the business
string
{{business.address_1}}
The first line of the business's address
string
{{business.address_2}}
The second line of the business's address
string
{{business.city}}
The city of the business's address
string
{{business.postcode}}
The postcode of the business's address
string
{{business.country}}
The country of the business's address
string
{{business.vat_number}}
The VAT number of the business
string
{{business.company_number}}
The company registration number of the business
string
{{business.currency}}
The currency used by the business
string
{{business.logo_url}}
The URL of the business's logo to be displayed on the invoice
string
{{business.bank_account_name}}
The name on the business's bank account
string
{{business.bank_account_number}}
The bank account number for payments
string
{{business.bank_sort_code}}
The sort code of the business's bank account
string
{{business.bank_iban}}
The IBAN of the business's bank account
string
{{business.bank_swift}}
The SWIFT code of the business's bank
string
{{business.brand_color}}
The brand color associated with the business
string

Payment

{{payment.amount}}
The amount to be paid by the client
string
Payment Confirmation Only
{{payment.currency}}
The currency in which the payment is made
string
Payment Confirmation Only
{{payment.reference}}
The reference number for the payment
string
Payment Confirmation Only

Custom Fields

{{custom_fields}}
Array of custom field objects with field_label and value propertiesRequires looping with {% for %}
array