While clients can easily onboard their workforce onto Deel HR using the Mass Import feature, there are sometimes errors in uploading CSV files and employment agreements.

In this article:

About Mass Import for Deel HR

Tips for uploading exported data in CSV

CSV file troubleshooting

CSV file field names

Employment Agreements

Common Errors Uploading Employment Agreements

Invite Method

Deel HR Country Codes

Deel HR State Names

Compensation Currency Codes

 

Mass Import process

With our Mass Import feature, you can easily onboard workers onto the platform using a CSV file upload. To get started, click Add People below the Home button, then click Mass Import on the Add New People page. 

From there, you'll select the Worker Type (defaults to Direct Employee, more options to be added in future releases) and click Continue.

 

 

Next, fill in your Organization Details and then you can upload the CSV file.

Please use our Deel People Import Template to upload your employee data onto the platform. It is pre-formatted and includes all the necessary columns required by Deel HR. 

You can download the template along with the sample from the Import People page.

 

If you experience any errors during the upload process, see CSV file troubleshooting for help with resolving common upload errors.

Once you've uploaded the CSV file successfully and there are no errors found in the upload, the file will go through data validation.

Once data validation has succeeded, the next step is to add Employment Agreements (EAs). This is an optional step in which you can select individual employees and upload their Employment Agreements. See Employment Agreements for details on adding EAs. Click Continue to move on to the next section. 

Compliance & Extras is the next step in the upload process. From here, you can add identity verification, coworking, and background check for employees. Each service has its own cost per employee, which will be added to the total monthly cost for each entity it is added. Click Select Workers beside each service to add employees to that service. After adding the desired services to each employee, click Continue to move to the final step.

Note: If the Select Workers button is greyed out, this means there are no workers eligible for the service(es).

Finally, the Review and Upload section allows you to view a summary of the additional monthly costs incurred after completing the import.

 

Tips to ensure a successful CSV file upload:

✅ Step 1 - Format your CSV file correctly

The format of the CSV file must be correct for Deel HR to accept it. Before uploading, please ensure the following:

• The file is in CSV format.
• The columns are in the same order as in the sample file and the first row contains column headers.
• The column headers match the field names in Deel HR.
• Double-check that your CSV file is in line with Deel HR-specific data requirements to avoid confusion and errors. You may use the sample file as a reference.

 

✅ Step 2 - Check for errors in your CSV file

To avoid errors, double-check your CSV file for accuracy and ensure that all fields are populated with the correct data.

To avoid inconsistent data, ensure the data in the CSV file follows the Deel HR system's data format requirements above. You can use Microsoft Excel or Google Sheets to standardize the data format before importing.

Common errors include:

• Missing data
• Incorrect formatting
• Duplicate entries.
• Using special characters.

 

✅ Step 3 - Map your CSV file to Deel HR fields

As an example, if your CSV file has a column for Employee ID, you need to map it to the Employee Number field in Deel HR. This ensures the data is imported correctly and avoids any data mismatches.

 

✅ Step 4 - Review your CSV file before importing

Use the Review & Upload page to confirm the full list of employees that will be uploaded, as well as any costs associated with the upload. Once you're satisfied and ready to continue, check the box I confirm that I have reviewed and approve the imported data then click Upload. 

 

Possible issues when uploading a CSV file

There are two stages of checking your CSV file for errors:

1. At the Upload CSV stage, the file is checked for general errors (file size, incorrect format, empty CSV file, etc.) and column issues. 
2. If no errors were detected at the Upload CSV step, then you get to the Validate data step, where value errors are pointed out. This is where incorrect values are pointed out, meaning if a value doesn't meet the requirements stated on the template. For example, using South Korea instead of KR for Employee Nationality. 

[ACCORDION] CSV file is too large

This is a common error when importing CSV files and could happen as a result of too many fields, records, columns, or rows. The max file size for a CSV upload is 10MB. The file must also have no more than 1,000 rows.

If your file is too large, you’ll see the following error message: 

Solution: consider breaking the file into smaller files. This can help reduce the number of records or columns and optimize the import process.

[ACCORDION] Data doesn’t match

This can occur when columns don't match expected field names, field names are not on the first line or the complete absence of column names. This may also occur when the expected columns are in the wrong order or the required fields are missing.

Solution: ensure the expected field names and column order in the CSV file match the data format requirements mentioned above. You can also use data validation tools to check for matching errors and correct them before importing.

[ACCORDION] Duplicate data

This occurs when there are multiple records in the CSV file for the same employee. 

Solution: Ensure the CSV file only contains one record per employee. You can also use data cleaning tools to detect and remove duplicate records before importing.

[ACCORDION] Incorrect values

A data validation error could occur with one or more fields in the CSV file because it does not conform to the expected format or data type.

Solution: review the CSV file and check for any formatting errors or inconsistencies in the data. Here are some steps you can take:

• Verify the data types: check if the data in each field is in the correct data type. For example, if a field is expecting a date, ensure that the data is formatted as a date and not as text.
• Check for missing data: ensure that there are no blank fields where data is expected. For example, group names, departments, etc cannot be created via import, they need to be created and filled in, in advance of import.
• Remove special characters: special characters like commas or quotes are not accepted in currency formatting, hence remove any special characters, that may be causing an issue. 
• Double-check the data: review the data in the CSV file to check for incorrect column headers or unaccepted values and make sure it matches the data format required by the platform.

[/ACCORDION]

 

What fields should be on the CSV file?

Important: field names with asterisks are mandatory to complete the Mass Import.

[ACCORDION] CSV Fields

Legal Entity*	Value must match the name of the entity created in your Organization Settings.   Further resources: What are entities and organizations on Deel?
Group*	Value must match the name of the group created in your Organization Settings.
Employee First Name*	Must be a legal first name.
Employee Last Name*	Must be a legal last name.
Employee Email*	Email to which the employee will be invited to the Deel Platform. Ideally, this should be a personal email, so they don't get locked out of the platform if they lose access to their work email.
Employee Work Email	Email to which the employee will be invited to the Deel Platform. Ideally, this should be a personal email, so they don't get locked out of the platform if they lose access to their work email.
Employee Nationality*	Please use the country ISO code. Check the accepted values in the list below. Values must match exactly.    Employee Nationality values are equal to the Employee Country values. For example, ‘US’ would be the correct value for both fields.
Employee Country*	Please use the country ISO code. Check the accepted values in the list below. Values must match exactly.    Employee Nationality values are equal to the Employee Country values. For example, ‘US’ would be the correct value for both fields.
Employee State	Please use an employee state name for a respective country from the list below. Values must match exactly and be correctly mapped for the inputted country.    • Australia • Brazil • Canada • Japan • New Zealand • Russia • United States   Note: Employee State values differ from Employee Country and Employee Nationality values.
Department*	The value must match the name of the Department in your Organization Settings.
Direct Manager Email	Direct manager email must correlate to a worker already imported in the platform or in the upload batch
Job Title*	Input the worker’s job title for this role.
Seniority Level*	Value must be one from the list below. Values must match exactly. • C-level Executive • Senior Vice President • Vice President • Head of Department • Director • Principal / Staff (Individual Contributor Level 5) • Lead (Individual Contributor Level 4) • Senior (Individual Contributor Level 3) • Mid (Individual Contributor Level 2) • Junior (Individual Contributor Level 1) • Not applicable
Compensation Currency*	Check the list of accepted values below. Values must match exactly. Note: Only the currency code is accepted as valid inputs.
Gross Salary*	Workers’ yearly salary. Do not include currency and only input numeric values.
Contract Start Date*	Format is YYYY-MM-DD. Date can be from the past as well.
Employee Number	If you were using a different HRIS software before, your employee may have a unique number assigned. You can
Employment Type*	Value must be either:   PART_TIME FULL_TIME
Part Time Percentage	The percentage of time the employee is working. For example, use “50” for employees with Part_Time employment type.   Leave empty if an employee is full-time
Contract End Date	Leave empty for a contract to be active indefinitely until manually terminated   If the end date is before the current date, employee status will be 'Terminated'
Vacation Yearly Policy	Input should be a numeric value.    Days off per year. If the policy is unlimited, leave the field blank.
Vacation Accrual Start Date	Format is YYYY-MM-DD.   If Vacation Yearly Policy is unlimited, leave this field blank.

[/ACCORDION]

 

Employment Agreements

[ACCORDION] How to Add Employment Agreements

You can add Employment Agreements (EAs) during the import process by clicking Select Employees, then Upload to the right of the employee's name, then follow the on-screen instructions to navigate to the file wherever you have it stored and upload it by clicking the blue Upload button. 

Once an EA has been uploaded successfully, the upload button will change to a pencil, signifying that it can be edited. 

If you click on the pencil, you will get options to delete the EA or update it using the Replace button. 

After adding all the EAs, click Close and Continue to go back to the Employment Agreements page, then click Continue to proceed to the next step. 

[/ACCORDION]

 

Common Errors Uploading Employment Agreements

[ACCORDION] File is too large

This could happen as a result of too many fields, records, columns, or rows. The max file size is 5MB. 

If your file is too large, you’ll see the following error message: 

Solution: recreate the employment agreement so that it meets the size requirement and try uploading it again. 

[/ACCORDION]

[ACCORDION] File is not in the correct format

This happens when the file type uploaded is not a PDF. 

If the file type is incorrect, you'll see the following error message: 

Solution: recreate or save the employment agreement as a PDF file (.pdf) and try uploading it again.

[/ACCORDION]

 

Invite Method

[ACCORDION] Send Immediately

Using the Send Immediately option will immediately send an email to the imported employees for them to sign up with Deel. To use this option, select it from the Invite method section, check the box I confirm that I have reviewed and approve the imported data then click Upload. 

You will see a pop-up confirming the import is being processed. The upload progress will also be on the page behind the pop-up and, once the import is complete, you will receive a notification in the Notifications section of the platform.  

[/ACCORDION]

[ACCORDION] Send Later

Using the Send Later option you can send an invitation email to all workers to join Deel at any later point. You’ll find the imported workers in the “People” tab on your Homepage, you can bulk invite several workers by clicking on “More Actions”. You can also invite workers individually from their profile.

To use this option, select it from the Invite method section. 

[/ACCORDION]

[ACCORDION] Schedule Invite

Using the Schedule invite option, you can choose the date and time to have the signup email sent to the imported employees. To use this option, select it from the Invite method section. 

Select the Send email on date, the Timezone, and the Time for the email to be sent, then click Schedule Invite. 

You will be brought back to the Review and Upload page where you will see the option to edit the Send later details you just entered. You may click the Edit button to make changes to the date and time for the signup email to be sent or, if you're happy with the schedule, check the box I confirm that I have reviewed and approve the imported data at the bottom of the screen, then click Upload. 

You will see a pop-up confirming the import is being processed. The upload progress will also be on the page behind the pop-up and, once the import is complete, you will receive a notification in the Notifications section of the platform.  

[/ACCORDION]

 

Country, Compensation, and State Information 

[DROPDOWN] Select an option for more info.

[DROPDOWN-OPTION] Deel HR Country Codes

[ACCORDION] Country Codes

Andorra	AD
United Arab Emirates	AE
Antigua and Barbuda	AG
Anguilla	AI
Albania	AL
Armenia	AM
Netherlands Antilles	AN
Angola	AO
Antarctica	AQ
Argentina	AR
American Samoa	AS
Austria	AT
Australia	AU
Aruba	AW
Åland Islands	AX
Azerbaijan	AZ
Bosnia and Herzegovina	BA
Barbados	BB
Bangladesh	BD
Belgium	BE
Burkina Faso	BF
Bulgaria	BG
Bahrain	BH
Benin	BJ
Bermuda	BM
Brunei Darussalam	BN
Bolivia	BO
Brazil	BR
Bahamas	BS
Bhutan	BT
Bouvet Island	BV
Botswana	BW
Belarus	BY
Belize	BZ
Canada	CA
Cocos (Keeling) Islands	CC
Switzerland	CH
Cote D'Ivoire	CI
Cook Islands	CK
Chile	CL
Cameroon	CM
China	CN
Colombia	CO
Costa Rica	CR
Cape Verde	CV
Christmas Island	CX
Cyprus	CY
Czech Republic	CZ
Germany	DE
Djibouti	DJ
Denmark	DK
Dominica	DM
Dominican Republic	DO
Algeria	DZ
Ecuador	EC
Estonia	EE
Egypt	EG
Western Sahara	EH
Spain	ES
Ethiopia	ET
Finland	FI
Fiji	FJ
Falkland Islands (Malvinas)	FK
Micronesia, Federated States of	FM
Faroe Islands	FO
France	FR
Gabon	GA
United Kingdom	GB
Grenada	GD
Georgia	GE
French Guiana	GF
Guernsey	GG
Ghana	GH
Gibraltar	GI
Greenland	GL
Gambia	GM
Guadeloupe	GP
Greece	GR
South Georgia and the South Sandwich Islands	GS
Guatemala	GT
Guam	GU
Guyana	GY
Hong Kong	HK
Heard Island and Mcdonald Islands	HM
Honduras	HN
Croatia	HR
Haiti	HT
Hungary	HU
Indonesia	ID
Ireland	IE
Israel	IL
Isle of Man	IM
India	IN
British Indian Ocean Territory	IO
Iceland	IS
Italy	IT
Jersey	JE
Jamaica	JM
Jordan	JO
Japan	JP
Kenya	KE
Kyrgyzstan	KG
Cambodia	KH
Kiribati	KI
Comoros	KM
Saint Kitts and Nevis	KN
South Korea	KR
Kuwait	KW
Cayman Islands	KY
Kazakhstan	KZ
Laos	LA
Lebanon	LB
Saint Lucia	LC
Liechtenstein	LI
Sri Lanka	LK
Lesotho	LS
Lithuania	LT
Luxembourg	LU
Latvia	LV
Morocco	MA
Monaco	MC
Moldova, Republic of	MD
Montenegro	ME
Madagascar	MG
Marshall Islands	MH
North Macedonia	MK
Mali	ML
Mongolia	MN
Macao	MO
Northern Mariana Islands	MP
Martinique	MQ
Mauritania	MR
Montserrat	MS
Malta	MT
Mauritius	MU
Maldives	MV
Malawi	MW
Mexico	MX
Malaysia	MY
Mozambique	MZ
Namibia	NA
New Caledonia	NC
Niger	NE
Norfolk Island	NF
Nigeria	NG
Nicaragua	NI
Netherlands	NL
Norway	NO
Nepal	NP
Nauru	NR
Niue	NU
New Zealand	NZ
Oman	OM
Panama	PA
Peru	PE
French Polynesia	PF
Philippines	PH
Pakistan	PK
Poland	PL
Saint Pierre and Miquelon	PM
Pitcairn	PN
Puerto Rico	PR
Portugal	PT
Palau	PW
Paraguay	PY
Qatar	QA
Reunion	RE
Romania	RO
Serbia	RS
Russia	RU
Rwanda	RW
Saudi Arabia	SA
Solomon Islands	SB
Seychelles	SC
Sweden	SE
Singapore	SG
Saint Helena	SH
Slovenia	SI
Svalbard and Jan Mayen	SJ
Slovakia	SK
Sierra Leone	SL
San Marino	SM
Senegal	SN
Suriname	SR
Sao Tome and Principe	ST
El Salvador	SV
Swaziland	SZ
Turks and Caicos Islands	TC
Chad	TD
French Southern Territories	TF
Togo	TG
Thailand	TH
Tajikistan	TJ
Tokelau	TK
Timor-Leste	TL
Turkmenistan	TM
Tunisia	TN
Tonga	TO
Turkey	TR
Trinidad and Tobago	TT
Tuvalu	TV
Taiwan	TW
Tanzania, United Republic of	TZ
Ukraine	UA
Uganda	UG
United States	US
Uruguay	UY
Uzbekistan	UZ
Holy See (Vatican City State)	VA
Saint Vincent and the Grenadines	VC
Virgin Islands, British	VG
Virgin Islands, U.S.	VI
Viet Nam	VN
Wallis and Futuna	WF
Samoa	WS
Kosovo	XK
Mayotte	YT
South Africa	ZA
Zambia	ZM

[/ACCORDION]

[DROPDOWN-OPTION] Employee State Names

[ACCORDION] State Names for Australia, Brazil, Canada, Japan, New Zealand, Russia, USA

Australia

New South Wales

Victoria

Queensland

Tasmania

South Australia

Western Australia

Northern Territory

Australian Capital Territory

 

Brazil
Acre	Paraíba
Alagoas	Pernambuco
Amazonas	Piauí
Amapá	Paraná
Bahia	Rio de Janeiro
Ceará	Rio Grande do Norte
Distrito Federal	Rondônia
Espírito Santo	Roraima
Goiás	Rio Grande do Sul
Maranhão	Santa Catarina
Minas Gerais	Sergipe
Mato Grosso do Sul	São Paulo
Mato Grosso	Tocantins
Pará

 

Canada
Alberta	Nunavut
British Columbia	Ontario
Manitoba	Prince Edward Island
New Brunswick	Quebec
Newfoundland and Labrador	Saskatchewan
Northwest Territories	Yukon Territory
Nova Scotia

 

Japan
Aichi	Nagano
Akita	Nagasaki
Aomori	Nara
Ehime	Niigata
Gifu	Okayama
Gunma	Okinawa
Hiroshima	Saga
Hokkaidô	Saitama
Fukui	Shiga
Fukuoka	Shimane
Fukushima	Shizuoka
Hyôgo	Chiba
Ibaraki	Tokushima
Ishikawa	Tochigi
Iwate	Tottori
Kagawa	Toyama
Kagoshima	Tôkyô
Kanagawa	Wakayama
Kumamoto	Yamagata
Kyôto	Yamaguchi
Kôchi	Yamanashi
Mie	Ôita
Miyagi	Ôsaka
Miyazaki

 

New Zealand
Northland	Wellington
Auckland	Tasman
Waikato	Nelson
Bay of Plenty	Marlborough
Gisborne	West Coast
Hawke's Bay	Canterbury
Taranaki	Otago
Manawatu-Wanganui	Southland

 

Russia
Adygeya	Arkhangel'skaya oblast	Saratovskaya oblast
Altay	Astrakhanskaya oblast	Smolenskaya oblast
Bashkortostan	Belgorodskaya oblast	Sverdlovskaya oblast
Buryatiya	Bryanskaya oblast	Tambovskaya oblast
Chechenskaya Respublika	Chelyabinskaya oblast	Tomskaya oblast
Chuvashskaya Respublika	Irkutskaya oblast	Tul'skaya oblast
Dagestan	Ivanovskaya oblast	Tverskaya oblast
Ingushetiya	Kaliningradskaya oblast	Tyumenskaya oblast
Kabardino-Balkarskaya Respublika	Kaluzhskaya oblast	Ul'yanovskaya oblast
Kalmykiya	Kemerovskaya oblast	Vladimirskaya oblast
Karachayevo-Cherkesskaya Respublika	Kirovskaya oblast	Volgogradskaya oblast
Kareliya	Kostromskaya oblast	Vologodskaya oblast
Khakasiya	Kurganskaya oblast	Voronezhskaya oblast
Komi	Kurskaya oblast	Yaroslavskaya oblast
Mariy El	Leningradskaya oblast	Moscow
Mordoviya	Lipetskaya oblast	Sankt-Peterburg
Saha	Magadanskaya oblast	Yevreyskaya avtonomnaya oblast
Severnaya Osetiya	Moskovskaya oblast	Chukotskiy avtonomnyy okrug
Tatarstan	Murmanskaya oblast	Khanty-Mansiyskiy avtonomnyy okrug
Tyva	Nizhegorodskaya oblast	Nenetskiy avtonomnyy okrug
Udmurtskaya Respublika	Novgorodskaya oblast	Yamalo-Nenetskiy avtonomnyy okrug
Altayskiy krai	Novosibirskaya oblast
Kamchatskiy krai	Omskaya oblast
Khabarovskiy krai	Orenburgskaya oblast
Krasnodarskiy krai	Orlovskaya oblast
Krasnoyarskiy krai	Penzenskaya oblast
Permskiy krai	Pskovskaya oblast
Primorskiy krai	Rostovskaya oblast
Stavropol'skiy krai	Ryazanskaya oblast
Zabaykal'skiy krai	Sakhalinskaya oblast
Amurskaya oblast	Samarskaya oblast

[/ACCORDION]

[DROPDOWN-OPTION] Compensation Currency Codes

[ACCORDION] Currency Codes

United Arab Emirates Dirham	AED
Albanian Lek	ALL
Armenian Dram	AMD
Argentine Peso	ARS
Australian Dollar	AUD
Azerbaijani Manat	AZN
Bosnia and Herzegovina Convertible Mark	BAM
Barbadian Dollar	BBD
Bangladeshi Taka	BDT
Bulgarian Lev	BGN
Bahraini Dinar	BHD
Bermudian Dollar	BMD
Brunei Dollar	BND
Bolivian Boliviano	BOB
Brazilian Real	BRL
Bahamian Dollar	BSD
Pula	BWP
Belarusian Ruble	BYN
Belize Dollar	BZD
Canadian Dollar	CAD
Congolese Franc	CDF
Swiss Franc	CHF
Chilean Peso	CLP
Chinese Yuan	CNY
Colombian Peso	COP
Costa Rican Colon	CRC
Cuban Peso	CUP
Cape Verdean Escudo	CVE
Czech Koruna	CZK
Djiboutian Franc	DJF
Danish Krone	DKK
Dominican Peso	DOP
Algerian Dinar	DZD
Egyptian Pound	EGP
Ethiopian Birr	ETB
Euro	EUR
Fijian Dollar	FJD
British Pound	GBP
Georgian Lari	GEL
Ghanaian Cedi	GHS
Gibraltar Pound	GIP
Gambian Dalasi	GMD
Guinea Franc	GNF
Guatemalan Quetzal	GTQ
Guyanese Dollar	GYD
Hong Kong Dollar	HKD
Honduran Lempira	HNL
Haitian Gourde	HTG
Hungarian Forint	HUF
Indonesian Rupiah	IDR
Israeli New Shekel	ILS
Indian Rupee	INR
Icelandic Króna	ISK
Jamaican Dollar	JMD
Jordanian Dinar	JOD
Japanese Yen	JPY
Kenyan Shilling	KES
Kyrgyzstani Som	KGS
Cambodian Riel	KHR
Comorian Franc	KMF
South Korean Won	KRW
Kuwaiti Dinar	KWD
Cayman Islands Dollar	KYD
Kazakhstani Tenge	KZT
Kip	LAK
Lebanese Pound	LBP
Sri Lankan Rupee	LKR
Lesotho Loti	LSL
Latvian Lats	LVL
Moroccan Dirham	MAD
Malagasy Ariary	MGA
Macedonian Denar	MKD
Burmese Kyat	MMK
Mongolian Tögrög	MNT
Macanese Pataca	MOP
Mauritanian Ouguiya	MRO
Mauritian Rupee	MUR
Maldivian Rufiyaa	MVR
Malawian Kwacha	MWK
Mexican Peso	MXN
Malaysian Ringgit	MYR
Mozambican Metical	MZN
Namibia Dollar	NAD
Nigerian Naira	NGN
Nicaraguan Córdoba	NIO
Norwegian Krone	NOK
Nepalese Rupee	NPR
New Zealand Dollar	NZD
Omani Rial	OMR
Panamanian Balboa	PAB
Peruvian Sol	PEN
Kina	PGK
Philippine Peso	PHP
Pakistani Rupee	PKR
Polish Złoty	PLN
Paraguayan Guarani	PYG
Qatari Riyal	QAR
Romanian Leu	RON
Serbian Dinar	RSD
Russian Ruble	RUB
Rwandan Franc	RWF
Saudi Riyal	SAR
Swedish Krona	SEK
Singapore Dollar	SGD
Sierra Leonean Leone	SLL
Surinamese Dollar	SRD
Salvadoran Colón	SVC
Swazi Lilangeni	SZL
Thai Baht	THB
Tajikistani Somoni	TJS
Turkmenistan Manat	TMT
Tunisian Dinar	TND
Turkish Lira	TRY
Trinidad and Tobago Dollar	TTD
New Taiwan Dollar	TWD
Tanzanian Shilling	TZS
Ukrainian Hryvnia	UAH
Ugandan Shilling	UGX
US Dollar	USD
Uruguayan Peso	UYU
Vietnamese Dồng	VND
Samoan Tālā	WST
Silver	XAG
Gold	XAU
West African CFA Franc	XOF
South African Rand	ZAR

[/ACCORDION]

[/DROPDOWN]