This article will guide you through importing employees in bulk using the Import Employees feature.
Quick Navigation
Accessing the Employee Import Screen
To access the employee import screen, follow these steps:
Navigate to the dashboard by clicking on the logo. This will take you to the Company List page.
Find the company and click the People icon
in the corresponding row. This will open a list of employees.Click on Import and select Import Employees to open the import screen.
Importing Employees
On the import screen, you will find three main options:
Download Import Template
Upload Completed File
View Import History
Downloading the Employee Import Template
To ensure accurate formatting, begin by downloading the official import template:
Click Download Import Template.
An Excel file (named NewStarterImportTemplate) will be downloaded with the following column headers:
The import template includes built-in descriptions and available options to guide you in entering accurate information. Fields highlighted in light blue are mandatory, while fields highlighted in orange are conditionally mandatory. Conditional mandatory fields are only required when the corresponding dependent field is set to Yes.
Complete mandatory fields to ensure the import processes successfully.
Uploading the Completed Employee Import Template
Once you've filled out and saved the template:
Return to the Import Employees screen.
Upload the file by either:
Dragging and dropping it into the upload area, or
Clicking Browse to select the file from your device.
Notes:
You can upload up to five files at a time.
Files can be removed by clicking the delete icon next to them.
You need to choose a Pay cycle for each upload.
Click Upload to start the import process. After the upload, the files will appear in the Import History section, where you can track successful and failed records.
Viewing Employee Import History
To review past imports, click Import History on the Import Employees screen.
It provides a comprehensive view of all employee imports within your company. The following columns are displayed to access information easily.
Import ID – System-generated unique Number for the import
Date – Date of the file upload
Successful Records – Number of successfully imported entries.
Failed Records – Number of entries that failed to import.
Status – Status of the Import (e.g., Uploaded, Uploading, Processing, Processed, Error, Header Mismatch)
Actions – Options such as downloading success or error files.
Import History Filters
In the import screen, please click on the Filter 
icon to expand the view below. Click the filter icon again to collapse the filter section.
You will have the following filter options:
Import ID
Upload Date
Import Status
After filling in the fields, click Search to filter the list of import histories. To remove all entered filters and start fresh, click Reset.
Managing Employee Import Errors
If an import fails:
Look at the Status column in the Import History.
If the status is Processed but the import has errors:
A red Error File icon will be available in the Actions column.
Download the file and check the Errors column (last column) for details.
Please correct the errors and re-upload the file, or update the error file and upload it.
If you see a Header Mismatch error:
This typically indicates that the column headers in your file do not match the required template.
Download a fresh copy of the import template.
Copy your data into the new file to ensure the format is correct.
Re-upload the updated file.
To return to the import screen, click the orange back icon next to the Import History title.
Related Articles
Need Further Assistance?
Need help or have questions? Our team is just a message away—let us know how we can make things easier for you!