Skip to main content
Candidates & Talent Database

Import candidates from a CSV file

Prepare up to 500 rows, map fields, and choose whether to update existing profiles.

Before you start

  • You need upload permission and access to the selected job or Candidate Database.

  • Save as CSV UTF-8 (.csv). XLSX files must be exported to CSV.

  • Include 1–500 candidate rows, excluding the header.

  • Each row needs a valid, non-empty email, unique within the file regardless of capitalization.

  • Subscription and candidate capacity still apply; review limit messages with an administrator.

CSV import creates structured records; it does not attach or parse resume files.

Prepare columns

Use one row per person and unique headings. Map columns before importing; their order is flexible.

Column

Requirement or example

Email Address

Required; alex.taylor@example.com

First Name / Last Name

First name recommended; separate columns

Phone Number

Keep as text to preserve + and leading zeros

Experience (In months)

Whole number 0–1200; 36 means three years

Qualification / Top Skills

Text; separate skills with commas inside one cell

City / State / Country / Zip Code

Separate columns

Other fields

Map only fields offered by the importer

Quote CSV values containing commas, such as "JavaScript,React". Spreadsheet applications normally handle quoting on export.

Import

  1. Open the destination's candidate list and choose Add Candidates.

  2. Choose An existing job or Talent pool and check the destination shown at the top. Use Change if needed, then choose Add contacts → Import from CSV.

  3. Upload the file and review the preview.

  4. Use the pencil icon on each header to map its column to the matching CVViZ field. Map email to Email Address, and scroll horizontally to review all columns.

  5. Leave Consider 1st row as a contact unchecked for a header row. Check it only if the first row contains a person's details.

  6. Choose whether to Update existing contacts.

  7. Click Import contacts, review row results, and inspect sample profiles.

Existing candidates

Email matching uses candidates accessible in your workspace. With Update existing contacts unchecked, matched profile details stay unchanged and no new copy is created. Checked allows supplied mapped values to replace existing information.

When importing into a job through Add Candidates, an existing matched person can be added to that job even when updates are unchecked. Importing into the Candidate Database assigns no job. Do not use blank cells to erase fields; edit the profile directly.

Fix errors

  • Export unsupported workbooks as CSV UTF-8.

  • Map Email Address and correct missing, invalid, or repeated emails.

  • Split files exceeding 500 candidate rows.

  • Give every heading a unique, non-empty name.

  • Check quoting and encoding for shifted columns or unexpected characters.

Check the results, then retry only corrected failed rows to avoid repeating profile updates.

Contact support

candidate-import-template.csv

139 bytes• Spreadsheet

candidate-import-example.csv

434 bytes• Spreadsheet

Was this helpful?

Still need help? Ask the team