Skip to main content

MDP - Employee - Import Employees

Learn how to quickly import multiple employee records into the system

Sharabin Mathi avatar
Written by Sharabin Mathi
Updated over a month ago

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 import pay item screen, follow these steps:

  1. Navigate to the dashboard by clicking on the logo. This will take you to the "Manage Clients" list.

  2. Find the client and click the "People" icon in the corresponding row. This will open a list of employees.

  3. Click on "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:

  1. Click Download Import Template.

  2. An Excel file 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 and must be completed to ensure the import is processed successfully.

Uploading the Completed Employee Import Template

Once you've filled out and saved the template:

  1. Return to the Import Employees screen.

  2. 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 client. 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 clients. 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 with 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!

Did this answer your question?