Skip to main content
English (Canada) English (United Kingdom) English (Hong Kong) English (Malaysia) English (New Zealand) English (Singapore) Bahasa Melayu

Use variables in the advanced template editor

Updated

Available for the following plans: Employment Plus, Employment Unlimited
Available for the following HR plans: Premium, Platinum
Available for the following user access levels: Manager, Admin

Variables allow you to add, for example, an Employee Start Date field to your document. Then, when you go to issue said document, the platform will apply the start date you entered on the employee file. So this is a great way to reduce your need for having to individually apply the start date for an employee on all your documents. Simply add the variable and Employment Hero will take the heavy lifting out of this process for you.

You can use the Advanced Editor feature to create a customised list of variables that you can then add to your organisation's HR documents. You can also use this feature to edit a variable if the information needs updating. To read details on how to access the Template Management feature, refer to this article.

Custom variables

Custom variables are designed exclusively for admins and senders to fill out while finalising a document. Currently, recipients cannot edit or update custom variables.

 

Getting started

The below will walk you through how to create a variable and add it to your document.

Create a variable
  1. Open the required advanced editor document.
  2. Click the   button.
  3. Click the   Add button.
    Variable_1.jpg
  4. Complete the following variable creation fields:
    • Name.
    • Type.
      • String.
      • Select.
      • Date.
    • Initial value.
    • Auto-populate.
  5. Click the Save button. 
    Variable_2.jpg
Add a variable to your template
  1. Open the required advanced editor document.
  2. Click the   button.
  3. Click the Use button.
    Variable_3.jpg

Maintain

The below will walk you through how to edit a variable.

Edit a variable
  1. Open the required advanced editor document.
  2. Click the   button.
  3. Click the   button.
  4. Click the   Edit button.
    Variable_4.jpg
  5. Make the required changes and click the Save button.
    Variable_5.jpg

Further information

Default variables vs. Create your own variables

Employment Hero created a list of commonly used variables which automatically pull data from your employee/company info to populate your template. While the create your own option allows you to create a set of customised variables, you can use to suit your specific needs.  

Explanation of variable properties

Variable properties:

  • Name: Name of variable.
  • Type:
    • String: Variable presents as text.
    • Select: Variable presents as a selectable option from a dropdown.
    • Date: Variable presents as a date and date-picker.
  • Initial value:
    • Placeholder text for the variable field.
    • Note: When an initial value is entered, the variable becomes essentially mandatory. The variable will display in pink and prompt the issuer to complete it before issuing the document.
    • If auto-populated, this replaces any data of employee/company on hand.
    • If not auto-populated, this stays as placeholder text until edited.
    • If not edited, the final document will use placeholder text when issued to sender/recipient.
  • Auto-populate: Select which data field we have on hand to auto-populate this variable.
Do variables I make transfer between templates?

No variables you create will only be available in that specific document template, i.e. they do not cross over into your other templates

Explore related content

  • Managing your organisation's policies This feature allows you to choose from Employment Hero's pre-made content or to upload your own documentation and then share this content with your employees
  • Managing HR Documents This feature allows you to select a document, complete any required variables, and then email it onto the chosen employee to accept and sign

 

 

Powered by Zendesk