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

# The Referrals page

> Find, filter and manage every referral, add referrals one at a time or in bulk, and export.

> [!NOTE]
>
> **Who can do this:** *View Referrals* to see the page. *Manage Referrals* to add, edit, delete and change the status of referrals.
>
> **Availability:** Referrals need to be turned on for your account. Ask your Customer Success Manager.

The **Referrals** page is your list of every referral: who referred whom, for which job req, whether it counts, and what it has paid. From here you can add referrals yourself, add a whole batch at once, change statuses in bulk and export the list.

To get there, click **Referrals** in the top navigation, then the **Referrals** tab.

![The Referrals tab listing referrals with their referrer, job req, status chip, reward and Reward Status, and the New Referral button at the top right](https://mintcdn.com/journeyfront/GQjKlyAQmW_Mi7NI/images/referrals/referrals-page/gen-list.png?fit=max\&auto=format\&n=GQjKlyAQmW_Mi7NI\&q=85\&s=2b286f7f5faefe8f268ff4856f7b412b)

## What each column shows

These are the default columns:

| Column | What it shows |
| - | - |
| **Candidate Name** | The person who was referred. Click the name to open the referral's details. |
| **Referrer Name** | The employee who made the referral. |
| **Referrer User ID** | The User ID of the employee record the referrer is linked to. Blank when they aren't linked to one. Click to copy. |
| **Job Req** | The job req the referral is for. Referrals that aren't for a specific job show **General Referral**. |
| **Status** | Whether the referral counts: **Needs Review**, **Active** or **Denied**. With **Manage Referrals**, click the chip to change it. Hover a **Needs Review** chip to see why it was flagged. |
| **Reward** | The total reward for the referral, from its reward program. |
| **Reward Status** | What the referral has paid so far, worked out from its payouts. See [Reward Status](https://help.journeyfront.com/referrals/review-and-credit.md#reward-status). |
| **Application Status** | Where the candidate's application stands. |
| **Referred Date** | When the referral was made. |

Click **Edit Columns** to add more. The extra columns are grouped the same way as the filters:

* **Default Fields:** **Referrer Email**, **Candidate Email**, **Note**, **Origin**, **Referral Portal**, **Applied Date**, **Added By** and **Referral Code**.
* **Candidate Location:** **Candidate Country**, **Candidate Region/State** and **Candidate City**.
* **Reward & Payout:** **Reward Program**, **Paid**, **Owed**, **Upcoming**, **Next Earned On** and **Rewarded Date**. **Paid**, **Owed**, **Upcoming** and **Next Earned On** are pay data, so they're only listed for people who also have **Manage Referral Payouts**.
* **Employment:** the hire's **Start Date**, **Turnover Date**, **Employee Job Title**, **Job Profile**, **Tenure** and **Separation Reason**, from their employee record.
* **Job Location:** **Job Req Country**, **Job Req Region/State** and **Job Req City**.

**Added By** always shows who added the referral. Editing a referral or changing its status doesn't change it. Who made each change is in the candidate's history, on the Candidate Application's **Comments & Activities** tab.

> [!TIP]
>
> Everyone with **View Referrals** sees **Reward**, **Reward Program** and **Reward Status**, since those are the program's terms and the outcome, not amounts paid. Give **Manage Referral Payouts** only to the people who should see what employees are paid and owed.

The **Origin** column tells you how a referral came in:

| Origin | Meaning |
| - | - |
| **Referral Portal** | An employee submitted it on a referral portal. |
| **Referral Link** | A candidate applied through an employee's referral link. |
| **Manually Added** | Someone on your team added it on this page or on a candidate's record. |
| **API** | It came in through the Journeyfront API. |

## Search, filter and save views

* **Search** by referrer, candidate, email or User ID.
* Click **Filters** to filter by **Status**, **Job Req**, **Application Status**, **Origin** and **Referral Portal**. Add more filters for the referred date, **Reward Status**, **Added By**, candidate and job req location, reward amount, currency and program, **Payout Status**, **Rewarded Date**, the hire's **Employment Status** and their **Start Date**.
* Click **Save as New View** to keep your columns and filters as a tab of your own. On a view you made, **Save Changes** updates it and **Remove Changes** puts it back the way it was saved.

> [!TIP]
>
> Save a view filtered to **Status** is **Needs Review**. It gives you a short daily queue of referrals waiting on a decision.

Click **Export** to download the list with the columns and filters you have on screen. Without **Manage Referral Payouts**, the export leaves out the **Paid**, **Owed**, **Upcoming** and **Next Earned On** columns, and you can't sort by them.

## Add a referral

Use this when an employee tells you about someone in person, by email or anywhere outside the referral portal.

**1. Open New Referral**

On the **Referrals** tab, click **New Referral**.

**2. Enter the referrer**

Under **Referrer**, enter their **First Name**, **Last Name** and **Email**. Journeyfront matches the referrer to their employee record so their payouts follow their employment.

**3. Enter the candidate**

Under **Candidate**, enter their **First Name**, **Last Name** and **Email**. **Phone**, **Country**, **Region/State** and **City** are optional and are saved to the candidate's profile. If the email matches someone already in Journeyfront, the referral is added to that person.

**4. Choose the job req**

Under **Referral**, pick the **Job Req**, or check **General Referral** to refer the candidate without choosing a specific job req. For a job req, Journeyfront also creates the candidate's application for that job.

If the job req is on more than one of your referral portals, or it's a general referral and you have more than one portal, choose the **Referral Portal**. The referral, and its payouts, belong to the portal you pick.

**5. Add a note and invitation**

Add a **Note** if you'd like. For a job req referral, check **Email the candidate a link to apply** to send the candidate an invitation email with a link to begin their application.

![The New Referral window with Referrer, Candidate and Referral sections, a Referral Portal picker and the option to email the candidate a link to apply](https://mintcdn.com/journeyfront/GQjKlyAQmW_Mi7NI/images/referrals/referrals-page/gen-new-referral.png?fit=max\&auto=format\&n=GQjKlyAQmW_Mi7NI\&q=85\&s=606b4f90100ea3ab2da951fb2e6c4251)

**6. Create the referral**

Click **Create Referral**.

If the candidate already has an application for that job req, or has already been referred, Journeyfront warns you first. Click **Create Referral Anyway** to add it, or **Go Back** to change it.

> [!TIP]
>
> Leave the invitation box unchecked when the candidate has already applied or you plan to reach out yourself. The person adding the referral usually isn't the person who knows the candidate, so a personal note from the referrer often lands better.

A new referral that looks like a duplicate, a past applicant or a self-referral is flagged **Needs Review** automatically. See [Review, credit and Reward Status](https://help.journeyfront.com/referrals/review-and-credit.md).

## Add referrals in bulk

Use this to catch up on a stack of referrals, for example from a hiring event or a spreadsheet you kept before.

**1. Open Add Referrals**

On the **Referrals** tab, click **Actions**, then **Add Referrals in Bulk**.

**2. Choose how to add them**

Under **Add referrals by**, choose one:

* **Enter Them:** type one referrer, then each person they referred under **People They Referred**. Click **Add Person** for each new row. Leave a row's **Job Req** on **General Referral** for a general referral.
* **Upload a File:** upload a CSV or Excel file (up to 10 MB) with one referral per row. Identify the job req by its exact title in **Job Req**, or by **Job ID**.

**3. Check the referrals**

Click **Check Referrals**. Nothing is added yet. Journeyfront shows each row with its result:

* **Ready:** the row will be added.
* **Warnings** in amber, such as **Already has an application for this job req** or **Already referred by** another employee. The row is still added, so decide whether you want it before you continue.
* **Errors** in red, such as a missing email or a job req that matches several reqs. These rows are skipped.

If some job reqs are on more than one of your referral portals, choose the **Referral Portal** for the upload.

![The Add Referrals check results: three rows ready or with a duplicate warning, one row skipped for a missing candidate email, and the Add 3 Referrals button](https://mintcdn.com/journeyfront/GQjKlyAQmW_Mi7NI/images/referrals/referrals-page/gen-bulk-check.png?fit=max\&auto=format\&n=GQjKlyAQmW_Mi7NI\&q=85\&s=01e97822ecf4856b359225718a5e59f8)

**4. Add them**

Check **Email each candidate their job invitation** if you want to send invitations. Only referrals to a specific job req get one. Then click **Add** (for example **Add 3 Referrals**). Click **Back** to fix the rows first.

The upload file takes these columns:

| Column | Required |
| - | - |
| Referrer First Name, Referrer Last Name, Referrer Email | Yes |
| Candidate First Name, Candidate Last Name, Candidate Email | Yes |
| Referrer User ID | No. Links the referrer to that person's employee record. |
| Candidate Phone | No |
| Job Req or Job ID | No. Leave both blank for a general referral. |
| Note | No |

## Change many statuses at once

With **Manage Referrals**, check the boxes next to the referrals you want, then click **Change Status** in the bar above the list. Choose **Active** or **Denied** and click **Change Status**.

Denying referrals works the same as denying one at a time: their unpaid payouts become ineligible and each referrer is told. See [Review, credit and Reward Status](https://help.journeyfront.com/referrals/review-and-credit.md).

## Row actions

Click the menu at the start of a row for:

* **View Details** or **Edit** to open the referral. See [Referral details and milestones](https://help.journeyfront.com/referrals/referral-details.md).
* **View Candidate Profile** and **View Application**, which open in a new tab.
* **Delete** to remove the referral. This can't be undone, and a referral with paid payouts can't be deleted.

## Referrals on a candidate's record

Referrals also show in the **Referrals** card on the Candidate Profile and on the **Details** tab of the Candidate Application. Each one shows who referred the candidate, the job req, how it came in and its status.

From the card you can change the status, edit the referrer and note, link the referral to one of the candidate's applications with **Associated Application**, or delete it. To add one, click **New Referral** on the Candidate Profile or **Add** on the Candidate Application.

## FAQ

> [accordion] Why can't I see the New Referral button or change statuses?
>
> Those need the **Manage Referrals** permission. With only **View Referrals**, you can see and export the list but not change it. See [Permissions and portal admins](https://help.journeyfront.com/referrals/permissions.md).

> [accordion] Why do I only see some referrals?
>
> If your security role doesn't have **All Referral Portals Access**, you only see referrals from the referral portals you're an admin of.

> [accordion] Which job reqs can I pick in New Referral?
>
> Active job reqs. If the job you need isn't listed, choose **General Referral** or check the job req's status.

> [accordion] What happens if I add a referral for someone who already applied?
>
> Journeyfront warns you first. If you add it anyway, the referral is linked to their existing application, and it's flagged **Needs Review** because the person applied before the referral. You then decide whether it counts.

> [accordion] Does a bulk upload stop if one row has a problem?
>
> No. Rows with errors are skipped and the rest are added. Rows with warnings are added too, so check them on the results screen before you click **Add**.

> [accordion] Why is the Reward column blank on some referrals?
>
> The referral has no reward program, usually because it's a general referral or its job req doesn't offer a reward. Its **Reward Status** shows **No Reward**.

> [accordion] Can I undo a delete?
>
> No. Deleting a referral removes it for good. To stop a referral from paying without losing its history, set its status to **Denied** instead.

## Related

> [card] [Review, credit and Reward Status](https://help.journeyfront.com/referrals/review-and-credit.md)
>
> Decide which referrals count and see what each has paid.

> [card] [Referral details and milestones](https://help.journeyfront.com/referrals/referral-details.md)
>
> Open a referral to see its reward and record milestones.

> [card] [Referrers](https://help.journeyfront.com/referrals/referrers.md)
>
> See every employee who refers and what they've earned.

> [card] [Rewards on job reqs](https://help.journeyfront.com/referrals/job-req-rewards.md)
>
> Choose which reward a job req's referrals earn.


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