Select your platform and then browse by platform category

Who are you and what section are you in?

Automate document templates with the expanded variable library

Available for the following plans: Plus, Unlimited HR, Engage, Elite, Unlimited HR+Payroll
Available for the following HR plans: Premium, Platinum
Available for the following User Access levels: Admin

Document templates are now more efficient with the expanded variable library. You can now insert specific employee profile data, such as personal contact details and emergency information, directly into your contracts and offer letters. This update removes the need for manual placeholders and ensures your documents automatically populate with accurate information from the employee profile.

This article shows you how to manage the following:

Insert new employee variables into a template

Add personal and emergency contact fields

The variable library includes additional fields to help you automate document creation across all template types, including contracts, offer letters, compliance documents, and onboarding documents.

  1. Log in to Employment Hero.
  2. On the left-hand side menu, click on Compliance. 
  3. Click on Template Library.
  4. Navigate to the Document Templates editor.
  5. On the template you wish to edit, click on Actions.
  6. Click on Edit Template.
  7. Open the Variable Picker (the letter T in brackets icon along the top bar).
  8. You can select from and insert the following variables:
    • Organisation name
    • Logo
    • Employing Entity
    • Employee first name
    • Employee last name
    • Employee full name
    • Employee date of birth (Date)
    • Employee job title
    • Employee employment type
    • Employee salary
    • Employee probation length
    • Employee locations
    • Employee hours per week
    • Employee manager job title
    • Employee start date (Date)
    • Employee address line 1
    • Employee address line 2
    • Employee address city
    • Employee address state
    • Employee address postcode
    • Employee super percentage
    • Employee super amount
    • Employee salary incl super
    • Teams
    • Manager first name
    • Manager last name
    • Manager full name
    • Authorised signatory job title
    • Authorised signatory first name
    • Authorised signatory last name
    • Authorised signatory full name
    • Recipient Signature
    • Roster (Select)
    • Document Date
    • Contract type
    • Employee preferred name
    • Contractor trading name
    • Organisation address
    • Employee account email
    • Employee classification
    • Employee award
    • Drafter job title
    • Primary Cosigner Signature
    • Secondary Cosigner Signature
    • Tertiary Cosigner Signature
  9. Click the variable to insert it into your document.

Helpful Hint

When a document is generated for an employee, these fields automatically fill using their saved profile data. If an employee does not have a value for a field, the document leaves it blank without showing an error or broken placeholder.

Use region-specific and work rights variables

Depending on your organisation's region, you may have access to specific employment data fields. Global fields for work eligibility are also available.

  1. In the Variable Picker, locate the Employee category.
  2. For organisations in Australia and New Zealand, relevant regional fields appear in the picker.
  3. For all regions, you can insert the following work rights details:
    • Passport number
    • Visa type
    • Visa start date
    • Visa expiry date
    • Visa notes
    • Work eligibility status

Filter and search for variables by category

Find variables quickly using category filters

To save time when building templates, you can filter the variable list to show only the categories you need.

  1. Open the Variable Picker in the template editor.
  2. Locate the All categories dropdown menu below the search bar.
  3. Select a specific category (such as Employee, Company, Profile Fields, Custom Variables, or Signatures) to view only those variables.
  4. Use the Search bar and category filter together to narrow your results.
Distinguish between Profile Fields and Custom Variables

The variable picker provides a clearer distinction between organisation-level data and template-specific placeholders.

  • Profile Fields: This section displays organisation-level custom HR profile fields, such as Department Code or Employee Badge Number.
  • Custom Variables: This section displays manual placeholders created specifically for the current template.

Further information

Are there any fields that cannot be inserted?

Certain sensitive or specialised fields are currently out of scope for the variable library. These include:

  • Tax numbers
  • Employee gender fields
  • Financial-sensitive fields requiring further policy review

Explore related content

Was this article helpful?
0 out of 0 found this helpful