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

# Referrers

> See every employee who refers, whether they still work here, and what they have earned.

> [!NOTE]
>
> **Who can do this:** *View Referrals* to see referrers. *Manage Referrals* to add, edit and upload referrers and remove portal photos. *Manage Referral Payouts* to see a referrer's payouts and pay amounts.
>
> **Availability:** Referrals need to be turned on for your account. Ask your Customer Success Manager.

The **Referrers** tab lists everyone who has referred someone to your company, with their employment status and what they've been paid and are owed. Journeyfront links each referrer to their employee record, so their rewards follow their real employment without anyone keeping a separate list.

To get there, click **Referrals** in the top navigation, then the **Referrers** tab. Everyone who refers someone appears here automatically.

![The Referrers tab listing referrers with their User ID, Referrer Status chip, start date, referral and hire counts, and paid, owed, overdue and upcoming amounts, including a referrer with Unknown status](https://mintcdn.com/journeyfront/GQjKlyAQmW_Mi7NI/images/referrals/referrers/gen-list.png?fit=max\&auto=format\&n=GQjKlyAQmW_Mi7NI\&q=85\&s=4785f5e93ef4ebae60f0060db4c22d80)

## What each column shows

| Column | What it shows |
| - | - |
| **Referrer** | The referrer's name. Click it to open their details. |
| **Email** | The referrer's email. |
| **User ID** | The User ID of the employee record they're linked to. Blank when they aren't linked. Click to copy. |
| **Referrer Status** | **Active**, **Exited** or **Unknown**. See below. |
| **Start Date** | Their start date, from their employee record. |
| **Referrals** | How many people they've referred. |
| **Hires** | How many of those were hired. |
| **Paid** | What they've been paid. |
| **Owed** | Earned and overdue payouts not yet paid. |
| **Overdue** | The part of **Owed** that has waited longer than your overdue setting. |
| **Upcoming** | Payouts scheduled but not earned yet. |

**Paid**, **Owed**, **Overdue** and **Upcoming** are pay data, so they only show for people who also have **Manage Referral Payouts**. Without it, they aren't in the list or **Edit Columns**, the export leaves them out and you can't sort by them.

Amounts in different currencies are never added together. A referrer paid in two currencies shows both, for example **CA\$250 + \$200**.

Click **Edit Columns** to add **Turnover Date**, **Employee Record** (**Linked** or **Not Linked**), **Last Referral** and **Note**.

## Search, filter and export

* **Search** by name, email or User ID.
* Click **Filters** to filter by **Referrer Status**, **Employee Record** and, with **Manage Referral Payouts**, **Overdue Payouts** (**Has Overdue Payouts**). Add filters for **Start Date** and **Turnover Date** too.
* Click **Save as New View** to keep your columns and filters as your own tab.
* Click **Export** to download the list as you see it.

> [!TIP]
>
> Filter to **Overdue Payouts** to find the employees who've waited too long to be paid. Then open **View Payouts** from their row to see exactly which installments are late.

## Referrer Status and the employee record

A referrer's status comes from the employee record they're linked to, so it changes on its own when your HR system or your team updates that record.

| Referrer Status | Chip | What it means |
| - | - | - |
| **Active** | Green | They have an open employee record. |
| **Exited** | Red | All of their employee records have ended. The **Turnover Date** shows when. |
| **Unknown** | Grey | They aren't linked to an employee record. |

Journeyfront links a referrer to an employee record in your account:

1. **By User ID**, when one is entered on the referrer or in an upload.
2. **By email** otherwise, matching the referrer's email to the person's email.

If someone was rehired, any open record makes them **Active**.

Employment matters for payouts. If the referrer leaves before an installment is earned, that payout becomes **Ineligible** with the reason **Referrer left before it was earned**. A referrer with **Unknown** status is treated as still employed, because Journeyfront can't show they left.

> [!TIP]
>
> When a referrer shows **Unknown** but you know they work here, their referral email probably differs from the email on their employee record. Edit the referrer and enter their **User ID** to link them.

See [Employee records](https://help.journeyfront.com/employees/employee-records.md) and [HRIS integrations](https://help.journeyfront.com/integrations/hris.md) for how employee records are kept up to date.

## Add a referrer

Referrers are created automatically when someone makes a referral. Add one yourself when you want to set them up ahead of time.

**1. Open New Referrer**

On the **Referrers** tab, click **New Referrer**.

**2. Enter their details**

Enter **First Name**, **Last Name** and **Email**. Add a **User ID** to link them to a specific person, if their email doesn't match, and a **Note** if you'd like.

**3. Create the referrer**

Click **Create Referrer**.

If no one in your account has the User ID you entered, Journeyfront tells you and nothing is saved.

## Upload referrers

Use an upload to add or update many referrers at once, for example people your HR system doesn't cover.

**1. Open Upload Referrers**

On the **Referrers** tab, click **Actions**, then **Upload Referrers**.

**2. Choose your file**

Pick a CSV or Excel file (up to 10 MB) with the columns **Email**, **First Name**, **Last Name** and **User ID**. Employment isn't uploaded. It always comes from the linked employee record.

![The Upload Referrers window listing the Email, First Name, Last Name and User ID columns, with a file chosen and the Upload button](https://mintcdn.com/journeyfront/GQjKlyAQmW_Mi7NI/images/referrals/referrers/gen-upload.png?fit=max\&auto=format\&n=GQjKlyAQmW_Mi7NI\&q=85\&s=d6d4616663bc05cf7b84f5986d676cdd)

**3. Upload**

Click **Upload**. Each row updates an existing referrer with the same User ID, then the same email, or adds a new one. A User ID links the referrer to that person. When it's done, Journeyfront shows how many referrers were added and updated.

If any row has a problem, such as a missing email, the same email twice or a User ID that isn't in your account, nothing is imported. Journeyfront lists each problem by row so you can fix the file and upload it again.

## The referrer's details

Click a referrer's name, or open the row's menu and click **View Details**.

![A referrer's details with Referrer Details and portal photo, Employment linked to an employee record, Rewards totals, and their Referrals and Payouts lists](https://mintcdn.com/journeyfront/GQjKlyAQmW_Mi7NI/images/referrals/referrers/gen-drawer.png?fit=max\&auto=format\&n=GQjKlyAQmW_Mi7NI\&q=85\&s=8b1c34e93a28f0ea1fbe581e3b06b61f)

| Card | What it shows |
| - | - |
| **Referrer Details** | **Email**, **User ID**, **Note** and, if they added one on the referral portal, their **Portal Photo**. |
| **Employment** | **Employee Record** (**Linked** or **Not Linked**), **Start Date** and **Turnover Date**. Click **View Candidate Profile** to see their employee records and applications together. |
| **Rewards** | **Referrals** and **Hires**, plus **Paid** and **Owed** with **Manage Referral Payouts**. |
| **Referrals** | Their recent referrals with the candidate, job req, referred date and application status. Click **View in Referrals** for the full list. |
| **Payouts** | Their recent payouts with the hire, installment, amount, **Earned On** date and status. Only with **Manage Referral Payouts**. Click **View in Payouts** for the full list. |

With **Manage Referrals**, click **Edit** to change their name, email, **User ID** or **Note**, then click **Save**.

### Remove a portal photo

Employees can add a profile photo on the referral portal, and coworkers see it there, for example on the leaderboard. If a photo isn't appropriate, click **Remove Photo**, then **Remove** to confirm. The photo is removed for everyone. Admins can remove a photo but can't add or change one.

## Row actions

Open the menu at the start of a row for **View Details**, **Edit**, **View Referrals** (the **Referrals** tab filtered to this referrer) and, with **Manage Referral Payouts**, **View Payouts**.

## FAQ

> [accordion] Why does a referrer show Unknown?
>
> They aren't linked to an employee record. Usually their referral email doesn't match the email on their employee record, or they don't have one yet. Edit the referrer and add their **User ID** to link them.

> [accordion] Do I need to update a referrer's employment myself?
>
> No. Employment comes from the employee record they're linked to. When that record ends, the referrer shows **Exited** and their unearned payouts are updated on their own.

> [accordion] Does an Unknown referrer still get paid?
>
> Yes. Journeyfront treats them as employed, because it can't show they left. Link them to their employee record so their payouts follow their real employment.

> [accordion] Can I delete a referrer?
>
> No. Referrers can't be deleted, so their referrals and payouts always show who made them. You can edit a referrer's details at any time.

> [accordion] Why are some amounts shown in two currencies?
>
> The referrer has rewards in more than one currency. Journeyfront never adds different currencies together, so each currency gets its own total.

> [accordion] Why did my upload import nothing?
>
> Uploads are all or nothing. If any row has a problem, no rows are imported. Fix the rows listed and upload the file again.

## Related

> [card] [The Referrals page](https://help.journeyfront.com/referrals/referrals-page.md)
>
> Every referral and who made it.

> [card] [Payouts](https://help.journeyfront.com/referrals/payouts.md)
>
> Each installment and its status.

> [card] [Employee sign-in and access](https://help.journeyfront.com/referrals/portal-access.md)
>
> Who can sign in to the referral portal.

> [card] [Badges](https://help.journeyfront.com/referrals/badges.md)
>
> Recognize your top referrers.


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