Skip to main content
All CollectionsRecruitGeneral settings
Import the candidates to the system
Import the candidates to the system

A quick manual on how to import candidates into the system.

Updated over a week ago

The import functionality supports two file types: .csv and .xlsx. Before you upload a spreadsheet, make sure that all cells contain correct information, so that the system could process it.

⚠️ You can download the file (template) here in the .csv and xlsx formats.

Here’s the list of candidate fields:

Field name

Description

Data format

Example

full_name

Candidate full name

Text

John Doe

email

Work email address

Text (Email format)

gender

Candidate's gender

Text

Male / Female

skills

Candidates'

skills

Text

Regression testing

phone number

Candidate's phone number

Text (Phone number format)

+1 (123) 456-7890

skype_id

Skype username

Text

@JohnADoe

source

Candidate source

Text

Linkedin

linkedin_url

Candidates's LinkedIn profile URL

URL

position

Position

Text

Software Engineer

location

Candidate's location

Text

Berlin

facebook_url

Candidate's Facebook profile URL

URL

added_on

The date the candidate was added to the pipeline

Date (Must correspond with the date format in the company settings)

2023-12-01

date_of_birth

Candidate's date of birth

Date (Must correspond with the date format in the company settings)

1990-01-01

desired_salary

Expected salary

Number

10000

curency_code

Currency code for salary

Text

USD

notes

Recruiter notes about the candidate

Text

Perfect candidate.

created_by_id

Recruiter ID.
Can be an employee number at the company or a sequence number in the import document

Text or Number

id2

⚠️ Please note that when you import candidates, make sure that the imported data has the correct format of date (01.01.2021), phone number (+380), full name, and email address. All fields are validated by the system.


The current date format can be found in Settings → General. When you make an import, the imported dates have to correspond to the current date format in your account.

The import functionality can also be used to update multiple candidate profiles. All candidate profiles are linked to their emails.

When you import new data, you have to double-check if the uploaded candidate emails correspond to their actual system emails. If the candidate’s email doesn't match, a duplicate candidate record will be created within the system. If the import is successful, the current profile data will be updated.

It is important to mention that when a spreadsheet is saved, you have to select the comma as the delimiter.


​Importing data into the system

  1. Open the Settings and navigate to the Import.

If you can’t find the ‘Settings’ and the ‘Import’, it is very likely that you don’t have access to it. 🔒 If that’s the case, then address this issue to your system administrator.

2. In the menu, choose "Candidates," locate the desired file, upload it to the system, and click on the "Next" button.

3. Once the spreadsheet is uploaded, you can verify if all fields were imported properly. If some fields were not mapped automatically, then you can map the required fields manually.

4. The system supports automatic validation of imported data. If the imported data has an incorrect format, it will be colored in red.

⚠️ You have to edit the file, replace the invalid data with the correct one, and re-upload the file.

Track file upload history

Users can view the history of all uploaded files within the Import history. Furthermore, the system provides important details on this page such as the number of imported or updated skills, and also the number of errors. You can also open the journal and view detailed information about import errors.


Did this answer your question?