Available for the following plans: Employment Plus, Employment Unlimited
Available for the following HR classic plans: Premium, Platinum
Available for the following user access level: Admin
Updating your employee records individually is a very time-consuming process, which is why a CSV bulk uploading feature is essential.
This article explains how to use the Import Employees feature. This lets you choose from a pre-prepared template or your own CSV file and then bulk upload the data to your Employment Hero platform. It also includes a field mapping product so you can customise the location of specific data fields in your CSV file. Currently, you cannot use the Bulk Import feature to update Account Emails. This is due to the Account Email being used to map the changes in the CSV File to the correlating HR File.
Warning
- Please save a copy of the exported template from your platform when downloading existing data to edit. This way, in case of a mistake, you can re-upload the file containing the information you had before editing. The platform cannot revert to old data after a CSV upload has been done, so it is important to have a backup of your original existing data.
- Mandatory fields (marked with an asterisk [*]) cannot be removed or left blank. In all the downloadable spreadsheets, please do not remove or leave blank the following: First name, Last name, Account email, and Location.
Interactive learning
Getting started
Important
Within your CSV file, address details, such as street address and country, will need to be grouped together for a successful import.
Warning
Please do not delete any of the columns in your CSV file. If you delete or remove columns in your CSV file and upload it into the platform, this will result in clearing some of your data on the platform too. This will lead to errors and affect your records and system.
- Click the People menu.
- Click the Import Employees submenu.
- Choose the template you need:
- Advanced Import Employees (including pay details)
- Quick Import Employees
- Update Employee Employment Details
- Update Employee Custom Fields
- Choose whether to:
- Include existing user information
- Include terminated users
- Click the Download button.
- Enter the required details in the template you downloaded.
- Save the changes you made to the file.
-
Upload the file by entering it in the tile named Click or Drag file(s) here to upload.
- Click the Yes button.
- Map the columns in the CSV file to the correct fields in the HR platform.
Note: If the Contract Type column is included in the CSV then it must have one of the available options (Permanent or Fixed Term) filled in. It cannot be left blank.
-
Click the Continue button.
If there are no errors detected by the platform, you will now see the Imported Successfully page, which will list the number of employee records that have been both created and updated.
Otherwise, the platform will now present a list of errors in the data that you will first need to correct.
Note: Once you have successfully finished the import process, automatic email invitations will be sent to the new employees that you have just imported. Those emails will invite the new employees to create their HR/Employment Hero Work account password in their Employment Hero Work app, which is needed to begin the onboarding process.
FAQs
We recommend using the pre-prepared sample CSV templates available.
We have also listed some tips below on how to best use these templates as well as important things to keep in mind so you can ensure a successful CSV upload:
- Add a personal email in the Account Email column. Employees will then still be able to log in to access their read-only information after they leave your organisation.
- Do not use a generic email for your employees (such as info@company.com).
- If you receive any error messages during your upload, the error message always corresponds to the following row. For example, an error in row one means the error is in row two, and so on.
- Always ensure mandatory fields (those with asterisks) are filled out properly.
- Follow all naming conventions referenced in the column headers of your CSV. For example, if an employee is in multiple teams (such as HR, Admin, and Payroll), you must separate those team names with the following symbol: | (in other words, it should look like this: John Smith HR | Admin | Payroll).
- Start dates and job titles are interdependent in the CSV that's named 'Update Employee Employment Details'. You can not complete one field without the other.
- Salary and Pay Details effective date are interdependent in the CSV named 'Advanced Import Employees (including Pay Details)'. You can not complete one field without the other.
- Downloading the CSV named 'Advanced Import Employees (including Pay Details)' removes the leading zeroes from sort codes and account numbers. You must reformat these columns by making the column custom. This is so you can add six zeros for sort codes and eight zeros for account numbers where required.
We recommend you have your employees' data in Employment Hero before you assign their teams and managers. You can then use the Update Employment Details template to assign teams and primary/secondary managers to employees in bulk.
Troubleshooting
If you receive general errors when bulk-updating employees via a CSV file, try splitting them into separate files based on key differences (such as employment type). Then, upload each file separately.
For example, if your CSV includes both hourly and salaried employees and you encounter an error, move the hourly employees into a separate file. Upload the salaried employees first, followed by the hourly employees. This helps prevent formatting issues and ensures a smoother update process.
| Additional spaces | Any cell that starts or ends with a space can cause an error in the upload. |
| Format errors |
When copying from Excel to CSV, the format changes. This also changes the data, most often with numbers that have leading zeros, such as bank account codes or phone numbers. You will need to reformat the column to a custom format that includes the zero. |
| Additional hyphens | Bank details are the most common to have added hyphens. There should not be hyphens in these sections. |
| Data missing from columns linked to other columns |
When inputting data into certain columns, you will need to fill out others. Examples are the super columns, banking columns, and tax columns. If you do not have all the data, it is better to delete all these related columns before you do the upload. You can come back instead when you have the data. |
| Missing column header | Ensure every column has a header and that no data exists in a cell without a corresponding header. |
| Uploading the advanced spreadsheet when Payroll settings are turned off | The platform will not allow this action. You need to delete all columns that have disappeared along with payroll settings, and then upload. |
| Missing surnames | Ensure every employee has a surname. If any surnames are missing, either remove those employees from the file or add the missing surnames. |
| Blank columns | If optional columns (e.g., the 'Cost Centre' and 'Primary & Secondary Managers' columns) have no data, delete them from the CSV to prevent errors. Keep only mandatory fields marked with asterisks. |
| Missing mandatory fields | Ensure all mandatory fields (marked with an asterisk) are filled out before uploading. Missing mandatory fields will cause the upload to fail. |
| Leading zeros appear in dates | If leading zeros appear in dates where they are not allowed, revise the formatting rules and remove them. |
| Unnecessary sheets in the import file | Having unnecessary sheets (sometimes called tabs) in the import file can lead to a failed import. Remove the data from any unneeded sheets and try the upload again. |
| General errors persist | If general errors persist, try uploading a smaller dataset (e.g. a file with only three employees) to manually pinpoint errors before reattempting to upload the full list. |
Important
If an import error occurs in the platform, it will show which row contains the error. However, note that the platform starts counting from the first employee in your CSV file and ignores the heading row.
For example, if the platform reports an error on row 10, look at row 11 in your Excel file to find and fix the issue.
To resolve import errors, follow the below steps:
Other fields (A to Z)
| ABN | Incorrect number of digits. |
| Account Columns |
|
| Account email | Account emails can only be changed within the person’s profile, not via CSV. If you change someone’s account email in the CSV, you will create a new employee. |
| Account Number Columns |
|
| Additional Cost Centres |
|
| Allocated Percentage Columns | Empty for those with multiple accounts. |
| Anniversary date [dd/mm/yyyy] | Not in dd/mm/yyyy format. |
| Classification |
|
| Company Landline |
|
| Company Mobile |
|
| Contract type [Permanent|Fixed term] |
|
| Contract type is only applicable for full-time and part-time employment types. |
|
| Could not assign the correct Pay Rate Template to employee | This error occurs when the pay rate template listed in the CSV data does not align with the classification and/or industrial instrument selected for the employee. Please ensure the correct pay rate template is listed. |
| Date of birth | Not in dd/mm/yyyy format. |
| Employing Entity | Misspelling. |
| Employment type [Full-time | Part-time | Casual] |
|
| End Date | Not in dd/mm/yyyy format. |
| ESA | Details missing from one column that is related to the others. |
| Fixed Amount Columns | Leaving empty. |
| Gender [Female | Male | Non-binary | Prefer not to say] |
|
| Home Phone |
|
| Industrial Instrument |
|
| Job Title | Leaving empty. |
| Leave allowance templates | To rename leave allowance templates (LATs) in the payroll platform so that the same name is not used against different templates. If awards are in use, it may be helpful to amend the name of the template to include the award number at the end to help differentiate the LATs. |
|
Line 1 contains empty header or columns |
This occurs when the CSV file has empty columns at the end of the document. To open this, open the file, delete or all needed 'Columns' and then save as CSV again. |
|
Line 0 unfortunately an error has occurred |
This error tends to occur when mandatory columns are removed from the CSV file. For more information on what columns are required when updating certain fields, please refer to the section CSV fields that need updating together in this article. |
| Marital status [Single | Married | In a Relationship] |
|
| Nationality |
|
| Pay category |
|
| Pay details - Effective from [dd/mm/yyyy] |
|
| Pay Rate Template |
|
| Pay schedule |
|
| Personal Mobile Number |
|
| Primary Cost Centre |
|
| Primary Manager Email |
|
| Salary option [Annum | Month | Fortnight | Hour] |
|
| Secondary Manager Email |
|
| SMSF Account Name | Details missing from one column that is related to the others. |
| SMSF Account Number | Details missing from one column that is related to the others. |
| SMSF BSB | Details missing from one column that is related to the others. |
| SPIN/USI | Pasted in incorrectly, causing error in cell. |
| Start Date | Not in dd/mm/yyyy format. |
| Super Account Name | Details missing from one column that is related to the others. |
| Super Choice [Regulated | SMSF | Company nominated] |
|
| Super Fund ABN |
|
| Super Member Number | Details missing from one column that is related to the others. |
| Tax File Number (TFN) |
|
| Team [separate multiple teams with '|'] | Not utilising the '|' symbol to separate multiple teams. |
| Termination Date |
|
| Timesheets [Enabled | Disabled | EnabledForExceptions] |
|
| Title [Mr | Ms | Mrs | Miss | Dr | Mx] |
|
| Type [Employee | Contractor] |
|
| Unable to touch historical versions | File imports are only able to update the 'current' salary record on an employee's profile or create a new record. It is not possible to amend previous salary records. To resolve this error, please ensure the Pay details - effective date matches the date listed on the employee's current salary details or list a new date to create a new salary record. |
Further information
CSV fields to update together
If you need to update the bank account details stored on your HR platform in bulk, you will need to update all the following fields together:
- BankAccount1_AccountName.
- BankAccount1_AccountBSB.
- BankAccount1_AccountNumber.
- BankAccount1_AllocatedPercentage (Not applicable for Xero payroll).
- BankAccount1_FixedAmount (Will always hold the remaining balance. Please enter 'Remaining').
You can only have one of the below columns in a row:
- BankAccount1_AllocatedPercentage (Not applicable for Xero payroll).
- BankAccount1_FixedAmount (Will always hold the remaining balance. Please enter 'Remaining').
If you need to update the Employment History details stored on your HR platform in bulk, you will need to update all the following fields together:
- Employment type (Full-time | Part-time | Casual).
- Job title.
- Start date (dd/mm/yyyy).
- Contract type.
If you include the Contract Type column in your CSV file, it must have either the Permanent or Fixed Term option filled in. It cannot be left blank.
If any employees have no contract type listed, an error will display and the upload will fail due to the blank field(s).
To avoid this, you can remove the Contract Type column entirely. As this field is optional, it does not need to be included in the CSV.
If you need to update the Superannuation details stored on your HR platform in bulk, you will need to update all the following fields together:
- The mandatory columns will depend on the Super Choice
- Super Choice [Regulated | SMSF | Company nominated].
- If you chose the Regulated or Company-nominated option, the below columns are mandatory:
- Super Fund Name.
- Super Fund ABN.
- SPIN/USI.
- Super Member Number.
- Super Account Name.
- If you chose the SMSF option, the below columns are mandatory:
- Super Fund Name.
- Super Fund ABN.
- ESA.
- Super Member Number.
- Super Account Name.
- SMSF Contact Email.
- SMSF Account Name.
- SMSF BSB.
- SMSF Account Number.
Important
Xero customers can use the CSV Pay Detail template to make bulk changes. However, after updating an employee’s salary details, they must follow steps seven onward in this article to ensure the changes sync to their Xero platform.
If you need to update the Pay details stored on your HR platform in bulk, you will need to update all the following fields together:
- Industrial instrument (If an employee is on an Industrial Instrument, you must also complete the Anniversary Date column.)
- Classification
- Pay rate template
- Salary
- Salary option (Annum | Month | Fortnight | Hour | Day)
- Actual weekly hours/days
- Full-time equivalent weekly hours/days.
You will need to enter data into the 'Pay Details - Effective From' column if you are to update any of the following columns:
- Industrial instrument (If an employee is on an industrial instrument, you must also complete the Anniversary Date column.)
- Classification
- Pay rate template
- Anniversary date (dd/mm/yyyy)
- Salary
- Salary option (Annum | Month | Fortnight | Hour | Day)
- Override template rate
- Pay schedule
- Pay category
- Leave allowance template
- Superannuation (%)
- Actual weekly hours/days
- Full-time equivalent weekly hours/days.