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

# Reward programs

> Define what a referral pays: the amount, currency, portals and an installment schedule by days or milestones.

> [!NOTE]
>
> **Who can do this:** Anyone with *View Referrals* can see reward programs. Creating and changing them takes *Manage Referral Settings*.
>
> **Availability:** Referrals need to be turned on for your account. Ask your Customer Success Manager.

A reward program is your referral bonus, written down once: how much it pays, in which currency, on which referral portals, and on what schedule. Attach it to your job reqs, and every referral to those job reqs earns it automatically. Journeyfront then works out each payout's date and amount for you.

## The Reward Programs tab

Go to **Referrals**, then **Reward Programs**. Each program is a card that shows:

* its name and status (**Active**, **Draft** or **Archived**)
* the referral portals it's on, or **All Referral Portals**
* the **Total Reward** and its installments, with when each one is due
* its effective dates and how many job reqs and referrals use it

![The Reward Programs tab with three program cards, the search box, the Referral Portal, Status and Currency filters, and the New Reward Program button](https://mintcdn.com/journeyfront/GQjKlyAQmW_Mi7NI/images/referrals/reward-programs/gen-programs-page.png?fit=max\&auto=format\&n=GQjKlyAQmW_Mi7NI\&q=85\&s=aa02072f073c01a9b3848b353e5fce57)

Use the search box to find a program by name or description, and the **Referral Portal**, **Status** and **Currency** filters to narrow the list. Archived programs are hidden until you add **Archived** to the **Status** filter. Click a card to open the program's details.

## Create a reward program

**1. Start a new program**

On the **Reward Programs** tab, click **New Reward Program**.

**2. Fill in the details**

Enter the program's settings. See the table below.

![The New Reward Program window with the program details and two installments of 200 and 300 dollars due after 90 and 180 days](https://mintcdn.com/journeyfront/GQjKlyAQmW_Mi7NI/images/referrals/reward-programs/gen-new-program.png?fit=max\&auto=format\&n=GQjKlyAQmW_Mi7NI\&q=85\&s=babad1f5d58ac9c967fe9ee6344ff27d)

**3. Add the installments**

Under **Installments**, add one row for each payment. Click **Add Installment** for another row. The **Total** at the top of the card adds them up as you go.

**4. Create it or save a draft**

Click **Create Reward Program** to make it active right away, or **Save as Draft** to finish it later.

| Setting | What it does |
| - | - |
| **Name** | Required. Shown to your team and to employees on the referral portal. |
| **Currency** | The currency every installment is paid in. A program has one currency. To pay in another currency, create another program. |
| **Referral Portals** | **All Referral Portals**, or **Specific Referral Portals** and the portals you pick. Employees on a portal only see that portal's programs. |
| **Description** | Shown to employees on the referral portal's rewards page. Use it to explain the bonus in plain words. |
| **Effective Dates** | Optional start and end dates. Only referrals made between these dates earn the program. Leave both blank and the program is always effective. |

Each installment has:

| Field | What it does |
| - | - |
| **Label** | Optional. Leave it blank and the installment is called "Installment 1", "Installment 2" and so on, or by its milestone's name. On the referral portal, an unlabelled installment is named by when it pays instead, such as "Day 180" or "Training Completed". |
| **Amount** | What this installment pays, in the program's currency. |
| **Due** | **Days After Start** or **Milestone**. |
| **Days or Milestone** | For **Days After Start**, the number of days after the hire's start date. For **Milestone**, a name like Training Completed. |

A program can have up to 12 installments. Day-based installments must be in order, earliest first. Milestones can go anywhere in the list.

> [!TIP]
>
> Split a large bonus into installments that line up with how long you want hires to stay, like \$200 after 90 days and \$300 after 180 days. You reward retention, not just the hire, and payroll sees smaller amounts spread over time.

### Days and milestones

A **Days After Start** installment is earned automatically: its **Earned On** date is the hire's start date plus its days.

A **Milestone** installment has no date until someone records that the hire reached it, for example finishing training. You record milestones on the **Payouts** tab, one at a time or by uploading a file, or with **Mark Reached** on the referral. See [Payouts](https://help.journeyfront.com/referrals/payouts.md) and [Referral details and milestones](https://help.journeyfront.com/referrals/referral-details.md).

Either way, an installment is only earned if the hire and the referrer are both still employed on its date.

## View a program's details

Click a program's card to open its details on the right side of the page.

![A reward program's details panel showing its total, portals, effective dates, payout schedule and the three job reqs that use it](https://mintcdn.com/journeyfront/GQjKlyAQmW_Mi7NI/images/referrals/reward-programs/gen-program-drawer.png?fit=max\&auto=format\&n=GQjKlyAQmW_Mi7NI\&q=85\&s=94d1f0a1332ce4deec99b94440333f7e)

The panel shows:

* **Reward Program**: the **Total Reward**, **Referral Portals**, **Effective Dates** and **Description**.
* **Payout Schedule**: each installment, when it's due and its amount.
* **Job Reqs**: every job req that uses the program, with how many referrals each one has under it. Click **View in Referrals** to see those referrals on the Referrals tab.

To change the program, click **Edit**. You can also click the menu on a card and choose **Edit**.

## Changes only apply to new referrals

Each referral keeps the program's terms from the day it was made. When you edit a program that referrals already use, a note at the top of the form tells you how many referrals keep their original terms. Your changes apply to new referrals only.

> [!TIP]
>
> To change a bonus going forward, you can edit the program or create a new one and switch your job reqs to it. A new program keeps the history clearer, since each program's name then matches one set of terms.

## Drafts, publishing and archiving

| Status | What it means | What you can do |
| - | - | - |
| **Draft** | Saved but not live. It isn't on any job req or portal. | **Publish** it to make it active, or **Delete** it. |
| **Active** | Live. You can pick it on job reqs, and employees see it on its portals. | **Archive** it when you stop offering it. |
| **Archived** | Retired. It stops paying new referrals and is hidden on the Reward Programs tab. | **Restore** it to make it active again. |

Find **Publish**, **Archive** and **Restore** in the menu on the program's card. A draft's details panel also has a **Publish** button. Once a program is published, it can't go back to being a draft.

Archiving doesn't touch what referrals already earned. Their payouts carry on as before. Job reqs that use an archived program keep showing it, but new referrals to them don't earn it. Pick a new program on those job reqs. See [Rewards on job reqs](https://help.journeyfront.com/referrals/job-req-rewards.md).

### Delete a program

You can delete a draft at any time. You can only delete a published program if no job req or referral has used it. Otherwise, archive it instead. To delete, click the menu on the card, choose **Delete**, then click **Delete** to confirm. This can't be undone.

## Programs and portal admins

If your role only covers some referral portals, you only see programs on your portals or on all portals, and new programs you create must be for your own portals. A program that's shared with portals you don't manage shows a lock icon instead of a menu. Only someone who manages all of its portals can change it. See [Permissions and portal admins](https://help.journeyfront.com/referrals/permissions.md).

## FAQ

> [accordion] Why can't I change which portals a program is on?
>
> Every job req that uses a program must be posted only on that program's portals. If you try to remove a portal that one of its job reqs is posted on, Journeyfront tells you which job reqs are in the way. Change their portals or their reward program first, then try again.

> [accordion] Why isn't my program in the job req's Reward Program list?
>
> Only **Active** programs can be picked, and only ones that cover every portal the job req is posted on. Publish a draft first, and check the program's **Referral Portals**.

> [accordion] What happens to referrals made outside the effective dates?
>
> They don't earn the program. Employees also stop seeing the reward on the portal once the end date has passed.

> [accordion] Can one program pay in two currencies?
>
> No. Each program has one currency. Create a program for each currency, such as one in USD and one in CAD, and put each on the right portals or job reqs. Totals across currencies are always shown separately, never added together.

> [accordion] Can I pay part of a reward at hire?
>
> Yes. Add an installment with **Days After Start** set to 0. It's earned on the hire's start date.

> [accordion] Why is Delete missing from a program's menu?
>
> The program is active or archived and a job req or referral has used it. Archive it instead, so the history of what it paid stays intact.

## Related

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

> [card] [Payouts](https://help.journeyfront.com/referrals/payouts.md)
>
> Track each installment from upcoming to paid.

> [card] [How referrals work](https://help.journeyfront.com/referrals/overview.md)
>
> The big picture and a setup checklist.

> [card] [Permissions and portal admins](https://help.journeyfront.com/referrals/permissions.md)
>
> Control who can create and change programs.


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