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

# Referral details and milestones

> Open a referral to see its people, status, portal and reward, and record when a hire reaches a milestone.

> [!NOTE]
>
> **Who can do this:** *View Referrals* to open a referral. *Manage Referrals* to edit it or change its status. *Manage Referral Payouts* to see its payouts and record milestones.
>
> **Availability:** Referrals need to be turned on for your account. Ask your Customer Success Manager.

Every referral has a details panel that brings together the candidate, the referrer, where the referral came from and what it pays. Once the candidate is hired, it also shows each payout and lets you record milestones like training completed, so the right reward is earned on the right day.

## Open a referral

On the **Referrals** tab, click the candidate's name, or open the row's menu and click **View Details**. The referral opens in a panel on the right. Click the **X** or press Esc to close it.

![A hired referral's details panel with Referral Details, Candidate, Referrer, the Reward card showing two payouts with their Earned On dates and status, and Application and Note](https://mintcdn.com/journeyfront/GQjKlyAQmW_Mi7NI/images/referrals/referral-details/gen-drawer.png?fit=max\&auto=format\&n=GQjKlyAQmW_Mi7NI\&q=85\&s=929c7e6e52174dabd3bb980db13746ce)

## The header

* **The candidate's name and status chip.** With **Manage Referrals**, click the chip to change the status. It saves right away. See [Review, credit and Reward Status](https://help.journeyfront.com/referrals/review-and-credit.md).
* **Referred by** the referrer, **for** the job req, or **General Referral**.
* **Edit**, **Candidate Profile** and **Application**. Candidate Profile and Application open in a new tab.

If the referral is **Needs Review**, a box under the header lists why and lets you decide. For a duplicate, it links to the referral that has the credit, so you can open it and compare. See [Review a flagged referral](https://help.journeyfront.com/referrals/review-and-credit.md#review-a-flagged-referral).

## What each card shows

| Card | What it shows |
| - | - |
| **Referral Details** | **Job Req**, **Origin**, **Referral Portal**, **Application Status**, **Referred Date**, **Applied Date**, **Referral Code** (click to copy) and **Added By** (who added the referral; edits and status changes don't change it). Once the candidate is hired and has an employee record, it adds **Employment** (**Active** or **Exited**), **Employee Job Title**, **Job Profile**, **Start Date**, **Turnover Date**, **Tenure** and **Separation Reason**. |
| **Candidate** | The candidate's **Email**, **Phone** and **Location**. |
| **Referrer** | The referrer's **Name**, **Email** and **User ID**. The name links to their Candidate Profile when they're linked to an employee record. |
| **Reward** | The reward program, its total and its schedule or payouts. See below. |
| **Application & Note** | The **Associated Application** the referral is linked to, and the **Note**. |

Employment details come from the hire's employee record. See [Employee records](https://help.journeyfront.com/employees/employee-records.md).

## The Reward card

The **Reward** card follows the referral from promise to payment.

**Before the hire**, it shows the **Reward Program**, the **Total** and the schedule copied onto the referral when it was made, for example **\$200 after 90 days**.

![The Reward card before the hire: Agent Referral Bonus, a \$500 total, \$200 after 90 days and \$300 after 180 days, and a note that payouts are scheduled when the candidate is hired](https://mintcdn.com/journeyfront/GQjKlyAQmW_Mi7NI/images/referrals/referral-details/gen-before-hire.png?fit=max\&auto=format\&n=GQjKlyAQmW_Mi7NI\&q=85\&s=80e6758ebe0e7ec0390b4e11c47ef4ec)

**After the hire**, people with **Manage Referral Payouts** see the payouts instead, one row per installment:

| Column | What it shows |
| - | - |
| **Installment** | The installment's name, and under it when it's due, for example **After 90 days** or **At Training Completed**. |
| **Amount** | What the installment pays. |
| **Earned On** | The date the installment is earned: the hire's start date plus its days, or the day its milestone was reached. A milestone not reached yet shows **Mark Reached**, or **Not reached** when the payout is already paid or ineligible. |
| **Status** | **Upcoming**, **Earned**, **Overdue**, **Paid** or **Ineligible**. Hover an **Ineligible** chip to see why. |

Click **View in Payouts** to see the same payouts on the **Payouts** tab. See [Payouts](https://help.journeyfront.com/referrals/payouts.md).

People without **Manage Referral Payouts** keep seeing the reward schedule, not the payouts.

> [!TIP]
>
> The reward is copied onto the referral when it's made, so changing a reward program later doesn't change what existing referrals promise. Only edit a referral's **Reward Program** when you mean to apply the program's current terms.

## Record a milestone

Some installments are earned at a milestone, like **Training Completed**, instead of after a number of days. Journeyfront doesn't know when the hire reached it, so someone with **Manage Referral Payouts** records the day.

**1. Find the installment**

Open the referral. In the **Reward** card, find the installment that shows **Mark Reached** under **Earned On**.

![The Reward card for a Training Bonus referral with a Training Completed installment waiting on its milestone and the Mark Reached button](https://mintcdn.com/journeyfront/GQjKlyAQmW_Mi7NI/images/referrals/referral-details/gen-mark-reached.png?fit=max\&auto=format\&n=GQjKlyAQmW_Mi7NI\&q=85\&s=be490d950346f1b61ec984799a57a0dc)

**2. Click Mark Reached**

The **Record Milestone** window shows the **Milestone**, the installment's **Label** when it has its own name, the **Amount** and the **Hire**.

**3. Enter the date**

Enter **Reached On**, the day the hire reached the milestone. It can't be in the future. Add a **Note** for other admins if you'd like, such as where the date came from. Employees never see notes.

![The Record Milestone window for a Training Completed installment with the amount, the hire, the Reached On date and a note](https://mintcdn.com/journeyfront/GQjKlyAQmW_Mi7NI/images/referrals/referral-details/gen-record-milestone.png?fit=max\&auto=format\&n=GQjKlyAQmW_Mi7NI\&q=85\&s=2633c8ab8866e2322ca62a47cf580f4b)

**4. Save**

Click **Record Milestone**. The installment is earned on that date, as long as the hire and the referrer were both still employed.

**Mark Reached** only shows on installments that can still pay. To change or clear a date you already recorded, use the **Payouts** tab: open the payout's menu, click **Change Milestone Date**, then change the date or click **Clear Reached Date**. You can also record many milestones at once there. See [Payouts](https://help.journeyfront.com/referrals/payouts.md).

## Edit a referral

With **Manage Referrals**, click **Edit**. You can change:

* The referrer's **First Name**, **Last Name** and **Email**.
* The **Reward Program**. Changing it applies the reward program's current terms. Draft programs aren't offered, and archived programs show **(Archived)**.
* The **Referral Portal**, if you work with more than one. The referral's payouts move with it.
* The **Associated Application** and the **Note**.

Click **Save**. If you close the panel or click **Cancel** with changes, Journeyfront asks before discarding them.

Once the candidate is hired and payouts are scheduled, the reward program can't change. Once any payout is paid, the associated application can't change either.

To delete a referral, use the row's menu on the **Referrals** tab. See [Row actions](https://help.journeyfront.com/referrals/referrals-page.md#row-actions).

## FAQ

> [accordion] Why don't I see payouts on a hired referral?
>
> Payouts are pay data, so they only show with **Manage Referral Payouts**. Without it, you see the reward schedule.

> [accordion] Why is the Reward Program box grayed out?
>
> Payouts are already scheduled from that program, so it can no longer change. Hover the box to see the reason.

> [accordion] What if the hire left before the milestone?
>
> The installment is only earned if both the hire and the referrer were still employed on the **Reached On** date. Otherwise it becomes **Ineligible**.

> [accordion] I recorded the wrong milestone date. How do I fix it?
>
> Go to the **Payouts** tab, open that payout's menu and click **Change Milestone Date**. Change the date, or click **Clear Reached Date**.

> [accordion] Where does the Employment information come from?
>
> From the hire's employee record in Journeyfront, which your HR system can keep up to date. If the hire has no employee record yet, those rows don't show.

> [accordion] Can I move a referral to a different portal?
>
> Yes, if you work with more than one referral portal. Click **Edit**, choose the **Referral Portal** and save. Its payouts move with it.

## Related

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

> [card] [Payouts](https://help.journeyfront.com/referrals/payouts.md)
>
> Every installment across all referrals.

> [card] [Reward programs](https://help.journeyfront.com/referrals/reward-programs.md)
>
> Set up rewards, installments and milestones.

> [card] [The Referrals page](https://help.journeyfront.com/referrals/referrals-page.md)
>
> Find and manage every referral.


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