This article guides Clients on using the Mass Import feature and a CSV file to bring in a significant number of Global Payroll Direct Employees to Deel at once.
In this article:
How to Mass Import Direct Employee Workers onto Deel
About Mass Import
Leverage Mass Import to effortlessly bring in a sizable group of workers to Deel by uploading a CSV file and kickstarting the onboarding process.
As a GP Client, you can create terminated contracts directly using the mass-import contract creation tool. This feature helps you efficiently manage parallel payroll, fulfill tax reporting, and keep historical employee records accurate and organized.
Worker types that clients can mass import:
- Direct employees that are being paid through Global Payroll (Global Payroll Direct Employees)
- Direct employees that have been hired through a local entity (Deel HR direct employees)
- EOR
- Pay As You Go, contractors,
- Fixed Rate contractors
- Milestone contractors
Learn more about importing these worker categories in the How To Use Mass Import Workers Onto Deel Using CSV Files article.
Worker types that clients cannot mass import:
- PEO employees
- COR (Contractors hired with additional misclassification coverage)
How to Mass Import Direct Employee Workers onto Deel
✅ Step 1 – Select Mass Import
Select the People Icon. Then click the Add People button on the top right.
Click Mass Import to begin importing a large group of workers onto Deel.
✅ Step 2 – Select worker type
Under Worker type select Direct employee global payroll. Click Continue.
✅ Step 3 – Organization settings
Select the Legal entity and the Group where the employees will be added.
Optional: Use the checkboxes to opt into importing “Additional details” and “Bank details” along with employee information.
Note:
- Additional details and Bank details are based on the country where the Entity was selected.
- If selected, these fields will be added to the CSV file as headers.
Click on Continue to proceed.
✅ Step 4 – Download, Fill, and Upload CSV File
Select View Guidelines to review explanations and formatting parameters for each field in the Mass Import Template.
Use the dropdown menu to set the Date Format for any dates that will appear in the CSV file.
Download the Mass Import Template and fill it in with employee data.
Terminated Contracts Mass Import
Clients can mass import terminated contracts by entering past contract end dates directly in the CSV file. This automatically marks these contracts as Inactive, simplifying your record-keeping and ensuring accurate employee status updates.
Ensure that the Contract End Date field in the CSV file contains a date in the past to properly set the contract status.
After completing the employee data template, proceed to upload the CSV file in the Upload CSV section, then click on Continue.
✅ Step 5 – Validate data
The Validate data screen will display all of the data from the file for review. If any errors are found in the file, they will be flagged on the screen.
Clients can view and edit the data directly on the platform to address any errors that may be present.
Optional: Select View Guidelines to review a list of all the fields that can be imported with an explanation of how to format the data for each one. The guidelines may aid clients in correcting any errors found in the data.
Note: Clients can identify and resolve errors directly in the UI grid if <100 errors. In case the errors are >100 the client needs to edit the CSV and re-upload it.
Double-click a field to edit the data. Updated entries will be saved automatically once the client clicks outside of the edited field.
After resolving all the errors, a green banner will appear to confirm that the data has passed validation.
Select continue to proceed.
✅ Step 6 – Review and import
In the final step, the clients can review the import summary and submit it.
Under Employee App, clients may opt to invite the imported new hires to the Deel app by checking the box and selecting an email category to send to. Newly imported employees will receive an email inviting them to create a Deel account where they can later review and sign their contracts.
Click View on the right to review the data imported for each worker.
Use the checkbox to confirm that the imported data has been reviewed and approved. Select Finish Import to submit.
FAQs
[ACCORDION] What fields must be included in the CSV file?
The following columns should be included in the CSV.
Fields marked with an asterisk (*) are mandatory.
- First Name*
- Last Name*
- Address line*
- City*
- Zip code*
- Address Country*
- Hire date*
- Is migrated from previous payroll*
- Email*
- Employee internal number*
- Pay currency code*
- Employment status (FT/PT)*
- Full time percentage*
- Location*
- Job title*
- Paid per*
- Paid rate*
- Date of birth
- Nationality
- Original hire date
- End date
- Personal Email
- Division Department
- Vacation days yearly policy
- Address State
- Cost Center 1
- Cost Center 1
- Allocation Percent
- Cost Center 2
[ACCORDION] Can clients use a CSV file to mass import EOR employees?
Yes. Clients can mass import the following worker types:
- Direct employees that are being paid through Global Payroll (Global Payroll Direct Employees)
- Direct employees that have been hired through a local entity (Deel HR direct employees)
- EOR
- Pay As You Go contractor
- Fixed Rate contractors
- Milestone contractors
Workers that cannot be mass-imported include:
- PEO Employee
- COR (Contractors hired with additional misclassification coverage)