> ## Documentation Index
> Fetch the complete documentation index at: https://help.journeyfront.com/llms.txt
> Use this file to discover all available pages before exploring further.

> ## Agent Instructions
> This is the Journeyfront Help Center for hiring teams. Journeyfront is an applicant tracking system (ATS). Use the Help Center's terms: job req, Candidate Profile (the person), Candidate Application (one person on one job req), hiring class. Link to the article you used in your answer.

# Import candidates

> Load a list of candidates from a CSV or Excel file into a job req, check the results and fix rows that didn't import.

> [!NOTE]
>
> **Who can do this:** Anyone who can open the job req: its hiring team, and users whose security role has *All Job Req Access*.
>
> **Availability:** You can import candidates while the job req is **Active**.

Use **Import Candidates** when you have a list of people to bring into one job req: sign-ups from a job fair, candidates from an agency, or a spreadsheet from another system. Each row becomes a Candidate Application, and Journeyfront can email everyone a link to finish applying.

For one person, see [Add candidates](https://help.journeyfront.com/sourcing/add-candidates.md). To let people apply on their own, see [Invite candidates](https://help.journeyfront.com/sourcing/invite-candidates.md).

## Import a list of candidates

**1. Open the Import Candidate window**

Open the job req, click **Actions**, then **Import Candidates**.

**2. Get the example file**

Click **Download Example File** for a CSV with the right column headers.

**3. Fill in your file**

Add one candidate per row. Save it as a CSV or Excel (.xlsx) file. See [Columns](#columns) below.

**4. Upload it**

Drag the file into the window, or click to select it.

**5. Choose whether to email them**

Tick **Send new candidates invite email** to email everyone in the file a link to complete their application.

**6. Click Import**

Journeyfront processes the file. You can wait for the results or close the window; you'll get an email with the results either way.

![The Import Candidate window with the Download Example File link, a selected CSV file, the Send new candidates invite email option ticked, and the Import button](https://mintcdn.com/journeyfront/61dBaB1hIRAsZpUl/images/candidates/add-and-import/gen-import-candidate.png?fit=max\&auto=format\&n=61dBaB1hIRAsZpUl\&q=85\&s=3568e048dfc5d6f3205b0df48d5fdbf4)

Imported candidates start at the beginning of the job req's workflow, just like someone who applied. Anyone already on this job req is skipped.

## Columns

Column headers aren't case sensitive, and columns can be in any order.

| Column | Required | What to enter |
| - | - | - |
| `email` | Yes | The candidate's email address. |
| `first_name` | Yes | First name. |
| `last_name` | Yes | Last name. |
| `phone` | No | Phone number. Include the country code (for example `+1`); without one, Journeyfront assumes the job req's country. |
| `source` | No | Must match the name of a source in your account. See [Sources](https://help.journeyfront.com/sourcing/sources.md). |
| `personal_field{Internal Name}` | No | A value for one of your personal fields. Put the field's **Internal Name** inside the braces, for example `personal_field{languages}`. |
| `application_field{Internal Name}` | No | A value for one of your application fields, written the same way. |
| `do_not_hire` | No | `true`, `yes` or `1` flags the person as Do Not Hire. See [Do Not Hire](https://help.journeyfront.com/candidates/do-not-hire.md). |
| `do_not_hire_reason` | No | The reason shown with the flag. |

For custom fields, a Multiple Choice value must match one of the field's options, and a Number value can only contain digits. See [Custom fields](https://help.journeyfront.com/account-setup/custom-fields.md).

> [!TIP]
>
> Fill in the `source` column, for example with the name of the job fair or agency. Otherwise imported candidates have no source, and your source reports can't count them. See [Magic links](https://help.journeyfront.com/sourcing/magic-links.md).

> [!WARNING]
>
> A row with a phone number opts that candidate in to text messages. Only include phone numbers for candidates who have agreed to receive texts from you.

If someone in your file is already in Journeyfront under the same email, they're added to the job req with the name and phone number they already have. The file doesn't change them.

## Check the results

When the import finishes, the window shows **Your Import is Complete** (or **Your Import Failed** if no rows were imported), with:

* **Total candidates successfully imported**
* **Candidates not imported because they are duplicates**, and the file lines they were on
* **Candidates not imported due to an invalid data format**, and the file lines they were on

Click **Download Import Results** for a copy of your file with a **status** column: **Success**, or the reason that row was skipped. The same file is attached to the results email. Line numbers count the header as line 1.

## Fix rows that didn't import

| Status in the results file | What to do |
| - | - |
| **Duplicate email** | The person is already on this job req. Nothing to do. |
| **Duplicate email (deleted user)** | The person has a deleted application on this job req. [Recover it](https://help.journeyfront.com/sourcing/add-candidates.md#recover-a-deleted-application) instead. |
| **Invalid email**, **Invalid first name**, **Invalid last name** | The value is missing or isn't valid. Fix it and import those rows again. |
| **Invalid phone number** | Add the country code, or remove the number. |
| **Invalid source** | Use a source name exactly as it appears in your account, or leave the column empty. |
| **Field does not exist:** followed by the column | Check the **Internal Name** inside the braces and the `personal_field` or `application_field` prefix. |
| **Invalid option value for** or **Invalid number value for** | Match the field's options exactly, or use digits only. |

If the whole file fails, check that it's a CSV or .xlsx file and that it has the `email`, `first_name` and `last_name` columns.

> [!TIP]
>
> Before importing a big list, import two or three rows first. Once those look right on the **Candidates** tab, import the rest. Rows that already imported are skipped as duplicates if you upload the same file again, so re-importing a corrected file is safe.

## Importing employees

To bring in employees rather than candidates, admins use **Settings**, then **Import Data**. It has its own templates for employee data and employee performance data. See [Importing data](https://help.journeyfront.com/account-setup/importing-data.md).

> [card] [Importing data](https://help.journeyfront.com/account-setup/importing-data.md)
>
> Import employees and their performance data from Settings, then Import Data.

## FAQ

> [accordion] Why can't I find Import Candidates?
>
> It's in the job req's **Actions** menu, not on the **Candidates** page. Closed and archived job reqs don't show it, and an **Inactive** job req shows a message that you can't import candidates. Activate the job req first. See [Job req statuses](https://help.journeyfront.com/job-reqs/statuses.md).

> [accordion] Do imported candidates get an email?
>
> Only if you tick **Send new candidates invite email** before you import. Otherwise nothing is sent, and you can reach out however you like.

> [accordion] Can I import candidates into several job reqs at once?
>
> No. Each import goes into one job req. Run a separate import from each job req.

> [accordion] Can I undo an import?
>
> There's no undo. To remove imported candidates, select them on the job req's **Candidates** tab and use **Delete**, if your security role allows it. See [Bulk actions](https://help.journeyfront.com/candidates/bulk-actions.md).

## Related

> [card] [Add candidates](https://help.journeyfront.com/sourcing/add-candidates.md)
>
> Add one person yourself and email them an invitation.

> [card] [Magic links](https://help.journeyfront.com/sourcing/magic-links.md)
>
> See which channels bring in your candidates.

> [card] [Custom fields](https://help.journeyfront.com/account-setup/custom-fields.md)
>
> Set up the personal and application fields you import into.

> [card] [Importing data](https://help.journeyfront.com/account-setup/importing-data.md)
>
> Bring in employee and performance data.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.