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

# How referrals work

> How employee referrals, reward programs, payouts and the referral portal fit together, plus a setup checklist.

> [!NOTE]
>
> **Who can do this:** People whose security role has *View Referrals* can open the **Referrals** section. Setting up portals and reward programs takes *Manage Referral Settings*, and payouts take *Manage Referral Payouts*. See [Permissions and portal admins](https://help.journeyfront.com/referrals/permissions.md).
>
> **Availability:** Referrals need to be turned on for your account. Ask your Customer Success Manager.

[Referrals](https://www.youtube.com/embed/buf1jKG9RQw)

Referrals turn your employees into a recruiting channel and keep every referral bonus on track, from the day someone is referred to the day payroll pays the reward. Employees refer people on a branded referral portal, your team reviews and credits each referral, and Journeyfront works out what each referrer has earned and when.

This page gives you the big picture. Each step links to a page with the details.

## The life of a referral

![The five steps of a referral: refer, review, hire, earn and pay, with the statuses each step uses](https://mintcdn.com/journeyfront/GQjKlyAQmW_Mi7NI/images/referrals/overview/gen-lifecycle.png?fit=max\&auto=format\&n=GQjKlyAQmW_Mi7NI\&q=85\&s=c32522e2bf8c5612d3204e45727a154b)

**1. An employee refers someone**

Employees refer people they know on your [referral portal](https://help.journeyfront.com/referrals/portal-setup.md), or share a referral link to a job. Anyone who applies through the link is recorded as their referral. Your team can also add referrals in Journeyfront, one at a time or in bulk. See [The Referrals page](https://help.journeyfront.com/referrals/referrals-page.md).

**2. Your team reviews it**

Most referrals start as **Active**. When a referral might not deserve the credit, for example someone else already referred the same person or the referrer referred themselves, it's set to **Needs Review** so a person can decide. You can make it **Active** or **Denied**. See [Review, credit and Reward Status](https://help.journeyfront.com/referrals/review-and-credit.md).

**3. The candidate is hired**

When you [hire the candidate](https://help.journeyfront.com/onboarding/hire-candidates.md), Journeyfront creates one payout for each installment of the referral's reward program. The reward program comes from the job req the person was referred to. See [Rewards on job reqs](https://help.journeyfront.com/referrals/job-req-rewards.md).

**4. Each payout is earned**

A payout is earned on its **Earned On** date: a number of days after the hire's start date, or the day a milestone like Training Completed is reached. The hire and the referrer both need to still be employed on that date. See [Payouts](https://help.journeyfront.com/referrals/payouts.md).

**5. Payroll pays it**

Earned payouts go into a payout batch that you hand to payroll. When payroll sends the results back, you record which payouts were paid. Journeyfront tracks what's owed and paid. Your payroll system pays the money. See [Payout batches](https://help.journeyfront.com/referrals/payout-batches.md).

## Key concepts

| Term | What it means |
| - | - |
| **Referral portal** | A branded page where employees refer people, see open jobs and, if they sign in, track their referrals and payouts. You can have more than one, for example one per region. |
| **Referral** | One person referred by one referrer, usually to a specific job req. |
| **Referrer** | The employee who made the referral. Journeyfront links referrers to their employee record so it knows whether they're still employed. |
| **Reward program** | What a referral pays: an amount, a currency and a schedule of installments. You attach a reward program to job reqs. |
| **Installment** | One part of a reward program, due a number of days after the hire's start date or when a named milestone is reached. |
| **Payout** | One installment for one hired referral. It moves through **Upcoming**, **Earned** or **Overdue**, and ends as **Paid** or **Ineligible**. |
| **Payout batch** | A group of earned payouts that you send to payroll at once, with a record of what payroll paid. |
| **Reward Status** | A summary of what a referral has paid so far, such as **Not Hired Yet**, **Owed**, **Partly Paid** or **Rewarded**. Journeyfront works it out from the referral's payouts. |

> [!TIP]
>
> Each referral keeps the reward program terms it was made under. If you raise a bonus next quarter, referrals made before the change still pay the old amount, so you can always explain any payout.

## Where things live

Everything your team works with day to day is in the **Referrals** section of the top menu. Its tabs are **Dashboard**, **Referrals**, **Referrers**, **Payouts**, **Payout Batches** and **Reward Programs**.

![The Referrals section header with the Dashboard, Referrals, Referrers, Payouts, Payout Batches and Reward Programs tabs](https://mintcdn.com/journeyfront/GQjKlyAQmW_Mi7NI/images/referrals/overview/gen-header-tabs.png?fit=max\&auto=format\&n=GQjKlyAQmW_Mi7NI\&q=85\&s=b313420eea5451cf1806ab4beabfe463)

**Payouts** and **Payout Batches** only appear for people with the *Manage Referral Payouts* permission, since they show pay data. The same goes for paid, owed and upcoming amounts on the other tabs.

Two other places hold referral settings:

* **Settings**, then **Referral Portals**: create and set up your portals, including branding, who can sign in, the referral form, email notifications and featured items.
* A job req's **Setup** tab, then **Configurations**: choose which portals show the job req and which reward program its referrals earn.

## Setup checklist

**1. Turn on Referrals**

Ask your Customer Success Manager to turn on Referrals for your account.

**2. Give your team access**

Add the Referrals permissions to the right security roles, and decide who should only manage certain portals. See [Permissions and portal admins](https://help.journeyfront.com/referrals/permissions.md).

**3. Create a referral portal**

Go to **Settings**, then **Referral Portals**, and click **New Referral Portal**. Add your branding and choose who can sign in. See [Set up a referral portal](https://help.journeyfront.com/referrals/portal-setup.md) and [Employee sign-in and access](https://help.journeyfront.com/referrals/portal-access.md).

**4. Create your reward programs**

Go to **Referrals**, then **Reward Programs**, and click **New Reward Program**. See [Reward programs](https://help.journeyfront.com/referrals/reward-programs.md).

**5. Put rewards on your job reqs**

On each job req, go to **Setup**, then **Configurations**. Choose the portals it shows on and its reward program. See [Rewards on job reqs](https://help.journeyfront.com/referrals/job-req-rewards.md).

**6. Share the portal with employees**

Copy the portal's link and share it with your employees. See [Using the referral portal](https://help.journeyfront.com/referrals/employee-portal.md) for what they'll see.

**7. Pay rewards on a schedule**

Each payroll cycle, check the **Payouts** tab and run a payout batch. See [Payouts](https://help.journeyfront.com/referrals/payouts.md) and [Payout batches](https://help.journeyfront.com/referrals/payout-batches.md).

> [!TIP]
>
> Connect your [HR system](https://help.journeyfront.com/integrations/hris.md) before you start paying rewards. Journeyfront uses employee records to know whether a hire or a referrer has left, which decides whether a payout can still be earned.

## FAQ

> [accordion] Does Journeyfront pay the rewards?
>
> No. Journeyfront tracks what each referrer has earned and when, and gives you payout batches to hand to payroll. Your payroll system pays the money, and you record the results back in Journeyfront.

> [accordion] Do employees need a Journeyfront account?
>
> No. Employees use the referral portal, not Journeyfront itself. Depending on the portal's settings, anyone can refer without signing in, or employees sign in to the portal to see their own referrals and payouts. See [Employee sign-in and access](https://help.journeyfront.com/referrals/portal-access.md).

> [accordion] What if two employees refer the same person?
>
> Only one referral gets the credit for a hire. The first referral keeps it, and the later one is set to **Needs Review**. You can move the credit to a different referral if that's the right call. See [Review, credit and Reward Status](https://help.journeyfront.com/referrals/review-and-credit.md).

> [accordion] What happens if I change a reward program?
>
> The change applies to new referrals only. Referrals made before the change keep the terms they were made under.

> [accordion] What if the hire or the referrer leaves?
>
> A payout is only earned if both people are still employed on its **Earned On** date. If either one leaves before then, the payout becomes **Ineligible** and won't be paid. Payouts that were already earned aren't affected.

> [accordion] Can a referral be for no job in particular?
>
> Yes. An employee can refer someone without picking a job. If that person later applies to a job req, the referral picks up that job req's reward program.

## Related

> [card] [Reward programs](https://help.journeyfront.com/referrals/reward-programs.md)
>
> Define what a referral pays and when.

> [card] [Set up a referral portal](https://help.journeyfront.com/referrals/portal-setup.md)
>
> Create the page employees use to refer people.

> [card] [The Referrals page](https://help.journeyfront.com/referrals/referrals-page.md)
>
> Find, add and update referrals.

> [card] [Payouts](https://help.journeyfront.com/referrals/payouts.md)
>
> Track what's upcoming, earned and owed.


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