> ## 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.

# Importing data

> Upload your employee and employee performance data, track each upload, and find where to import candidates.

> [!NOTE]
>
> **Who can do this:** Admins whose security role has both *Company Settings Access* and *Import Data*. Importing candidates into a job req only needs access to that job req.

**Settings**, then **Import Data** is where you send Journeyfront your employee data: who works for you, in which roles, and how they perform. That history powers your employee records, job profiles and turnover reporting. You upload a spreadsheet, and the page tracks each upload until it's imported.

Importing candidates works differently: you import them straight into a job req. See [Import candidates into a job req](#import-candidates-into-a-job-req) below.

## What you can import

**Import Data** has two tabs, each with its own template:

| Tab | What it's for |
| - | - |
| **Employee Data Import** | Your current and former employees: who they are, their job and job profile, their start date, and when and why they left |
| **Employee Performance Data Import** | Performance review results for your employees, by review period |

## Upload a file

**1. Open Import Data**

Go to **Settings**, then **Import Data**, and pick the **Employee Data Import** or **Employee Performance Data Import** tab.

**2. Download the template**

Click **Download Employee Data Import File Template** (or the performance one). Use the template's columns, one row per employee or review.

**3. Choose your file**

Click **Select file** and pick your file. It can be a .csv, .xlsx or .xls file.

**4. Click Upload File**

Your file appears at the top of **History** with the status **Import Pending...**.

![The Import Data page on the Employee Data Import tab: the template download link, a chosen file with the Upload File button, and the History table of past uploads](https://mintcdn.com/journeyfront/61dBaB1hIRAsZpUl/images/account-setup/importing-data/gen-import-data.png?fit=max\&auto=format\&n=61dBaB1hIRAsZpUl\&q=85\&s=a61c698350a1bad4cebd90ef1f43316a)

Uploads aren't imported instantly. The page notes it can take up to 14 days for your data to appear, and your Customer Success Manager can tell you where an upload stands.

> [!TIP]
>
> Send a small file first, a handful of employees, and check how they look in Journeyfront once it's imported. Fixing the format on 10 rows is much easier than on 10,000.

### The employee data template

The **Employee Data Import** template has these columns:

| Group | Columns |
| - | - |
| Who they are | `email`, `first_name`, `last_name`, `gender`, `dob`, `city`, `state_code`, `country_code` |
| Their job | `employment_type_code`, `job_title`, `profile_title` (the job profile they belong to), `start_date`, `supervisor_email` |
| If they've left | `end_date`, `separation_name` (the reason they left), `separation_note` |
| Your employee job fields | A column for each employee job field (the template shows them as `Custom Job Field "XXX"`) |

For `separation_name`, use a reason from your separation reasons list. See [Rejection and separation reasons](https://help.journeyfront.com/account-setup/rejection-reasons.md#separation-reasons). Employee job fields are set up in **Settings**, then **Custom Fields**. See [Custom fields](https://help.journeyfront.com/account-setup/custom-fields.md).

### The performance data template

The **Employee Performance Data Import** template has one row per review, with the employee (`first_name`, `last_name`, `email`, `hire_date`), the job (`job_id`), the reviewer and review (`evaluator_email`, `eval_date`, `period_name`, `period_year`), and then a set of columns for each performance question: `account_question_id`, `attribute_id`, `score` and `note`, numbered 1, 2 and so on.

The ID columns refer to the job and performance questions set up in Journeyfront. Ask your Customer Success Manager for the IDs to use. See [Performance reviews](https://help.journeyfront.com/employees/performance-reviews.md).

## Check your uploads

The **History** table on each tab lists every upload:

| Column | What it shows |
| - | - |
| **File Uploaded** | The file you uploaded. Click it to open your original. |
| **Date Uploaded** and **Uploaded By** | When, and who uploaded it |
| **Status** | **Import Pending...** until it's processed, then **Import Completed** or **Import Failed** |
| **Result File** | **Results** to download the results file once there is one, or **NA** |

If an upload says **Import Failed**, download the **Results** file to see what went wrong, fix your file and upload it again. Your Customer Success Manager can help if it isn't clear.

## Daily imports from your HR system

Some accounts have employee data imported automatically every day, straight from their HR system. If yours does, a **Daily Importer** section below **History** lists each day's run with its status. Click **View Results** to see what happened to each employee. This needs to be set up for your account; ask your Customer Success Manager.

## Import candidates into a job req

Candidates aren't imported in **Settings**. Import them into the job req they're applying to:

1. Open the job req and click **Actions**, then **Import Candidates**.
2. Click **Download Example File** for the columns: `email`, `first_name`, `last_name`, plus optional columns such as `phone` and `source`.
3. Drag in your .csv or .xlsx file, choose whether to tick **Send new candidates invite email**, and click **Import**.
4. Check the results: how many were imported, how many were duplicates and how many had invalid data. Click **Download Import Results** for the details, then **Done**.

For every column and how to fix rows that didn't import, see [Import candidates](https://help.journeyfront.com/sourcing/import-candidates.md).

## FAQ

> [accordion] I see Import Data in my menu, but it won't open.
>
> **Import Data** appears in the menu under your name for everyone, but opening it needs both *Company Settings Access* and *Import Data* in your security role. Ask an admin to check your role. See [Security roles and permissions](https://help.journeyfront.com/account-setup/security-roles.md).

> [accordion] How long does an import take?
>
> It can take up to 14 days for an upload to be imported. The **Status** column shows **Import Pending...** until then. Ask your Customer Success Manager if you need it sooner.

> [accordion] Can I import candidates here?
>
> No. **Import Data** only takes employee and performance data. Import candidates from a job req's **Actions** menu. See [Import candidates](https://help.journeyfront.com/sourcing/import-candidates.md).

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

> [accordion] Can I undo an import?
>
> Not from this page. If something was imported wrong, ask your Customer Success Manager how best to correct it before you upload again.

> [accordion] What file types can I upload?
>
> .csv, .xlsx and .xls files. Start from the template so the column names match.

## Related

> [card] [Import candidates](https://help.journeyfront.com/sourcing/import-candidates.md)
>
> Import a list of candidates into a job req.

> [card] [Employee records](https://help.journeyfront.com/employees/employee-records.md)
>
> Where imported employees show up.

> [card] [Rejection and separation reasons](https://help.journeyfront.com/account-setup/rejection-reasons.md)
>
> The separation reasons your employee import uses.

> [card] [Turnover and performance](https://help.journeyfront.com/reporting/turnover-and-performance.md)
>
> Reports built on your employee data.


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