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

# Permissions and portal admins

> Control who can view referrals, manage them, handle payouts and change settings, and limit admins to their own portals.

> [!NOTE]
>
> **Who can do this:** Admins with the *Company Settings Access* permission edit security roles. Anyone with *Manage Referral Settings* can choose a portal's admins.
>
> **Availability:** Referrals need to be turned on for your account. Ask your Customer Success Manager.

Referral data includes pay, so Journeyfront splits Referrals access into five permissions. You decide who can see referrals, who can change them, who handles payouts and who sets up programs and portals. You can also limit people to the referral portals they're responsible for, so a regional team only works with its own referrals and payouts.

## The Referrals permissions

Referrals permissions live in each security role, in the **Referrals** section. Go to **Settings**, then **Security**, and open a role. The section only appears when Referrals is turned on for your account. See [Security roles and permissions](https://help.journeyfront.com/account-setup/security-roles.md).

![A security role's Referrals section with the five Referrals permissions and their on and off switches](https://mintcdn.com/journeyfront/GQjKlyAQmW_Mi7NI/images/referrals/permissions/gen-security-role.png?fit=max\&auto=format\&n=GQjKlyAQmW_Mi7NI\&q=85\&s=d082adf7aed8633aa047ad3e8dad749a)

| Permission | What it allows |
| - | - |
| **View Referrals** | See the **Referrals** section: the dashboard, referrals, referrers and reward programs. Also needed to pick a reward program on a job req. |
| **Manage Referrals** | Add and edit referrals and referrers, and change referral statuses. |
| **Manage Referral Payouts** | View payouts and payout amounts, run payout batches for payroll, record what payroll paid and change payout statuses. It's needed everywhere pay data shows: the **Payouts** and **Payout Batches** tabs, the paid, owed and upcoming amounts on the **Referrals** and **Referrers** tabs and in their exports, a referral's payouts and the dashboard's payout amounts. |
| **Manage Referral Settings** | Create and edit reward programs, and create and set up referral portals under **Settings**, then **Referral Portals**. |
| **All Referral Portals Access** | Work with every referral portal. When it's off, the person only works with the portals they're an admin of. See [Limit someone to certain portals](#limit-someone-to-certain-portals). |

> [!TIP]
>
> Keep **Manage Referral Payouts** to the few people who should see what employees are paid. With **View Referrals** alone, people see each referral's **Reward**, **Reward Program** and **Reward Status** (what the program promises and how it turned out), but not the amounts paid, owed or upcoming. Recruiters can review and credit referrals with **Manage Referrals** without seeing pay data or sending it to payroll.

### Defaults

* **Existing roles** have **View Referrals**, **Manage Referrals** and **All Referral Portals Access** turned on. Roles with *Company Settings Access* also have **Manage Referral Payouts** and **Manage Referral Settings**.
* **New roles** start with the Referrals permissions turned off, except **All Referral Portals Access**, which is on. Turn on what the role needs before you save.

### What people without a permission see

Journeyfront hides what a role doesn't allow:

* Without **View Referrals**, the **Referrals** menu item and the job req **Reward Program** setting don't appear.
* Without **Manage Referral Payouts**, the **Payouts** and **Payout Batches** tabs don't appear and the dashboard leaves out payout amounts. The **Referrals** tab has no **Paid**, **Owed**, **Upcoming** or **Next Earned On** columns. The **Referrers** tab has no **Paid**, **Owed**, **Overdue** or **Upcoming** columns and no **Overdue Payouts** filter, and a referrer's **Rewards** card shows only **Referrals** and **Hires**. Exports leave those columns out, and you can't sort by them.
* Without **Manage Referral Settings**, there's no **New Reward Program** button, no menu on reward program cards, and no **Referral Portals** page in Settings.

## Limit someone to certain portals

If your company runs several referral portals, for example one per region, you can give each portal its own admins. A portal admin only sees and changes that portal's data.

**1. Turn off All Referral Portals Access**

In the person's security role, turn off **All Referral Portals Access** and click **Save**. Leave on the other Referrals permissions they need.

**2. Open the portal**

Go to **Settings**, then **Referral Portals**, and open the portal.

**3. Add them as an admin**

On the **General** tab, add the person under **Admins**, then click **Save**. Only people whose role has **View Referrals** appear in the list.

![The General tab of the Acme West referral portal with Priya Shah and Marcus Reed added as admins](https://mintcdn.com/journeyfront/GQjKlyAQmW_Mi7NI/images/referrals/permissions/gen-portal-admins.png?fit=max\&auto=format\&n=GQjKlyAQmW_Mi7NI\&q=85\&s=24249202c90400877ff85db23c229ca5)

People whose role has **All Referral Portals Access** already manage every portal. Adding them as a portal admin changes nothing for them.

> [!TIP]
>
> Their role still decides what portal admins can do. The portal list only decides where they can do it. A portal admin with **View Referrals** alone can see their portal's referrals but not change them.

### What a portal admin sees

| Area | What they work with |
| - | - |
| **Referrals** | Referrals that belong to their portals. |
| **Payouts** and **Payout Batches** | Payouts from those referrals. |
| **Referrers** | Referrers who referred through their portals, plus referrers with no referrals yet. |
| **Reward Programs** | Programs on their portals or on all portals. They can only change programs that are only on their portals. A program shared with other portals shows a lock icon. New programs they create must be for their own portals. |
| **Dashboard** | Numbers for their portals only. |
| **Referral Portals** settings | Only their portals. A portal they create lists them as an admin automatically. |
| **Job reqs** | When adding a referral, only job reqs posted on their portals or on all portals. |

Anything outside their portals behaves as if it doesn't exist for them. Account-wide settings, such as when an earned payout counts as overdue, can only be changed by someone with **Manage Referral Settings** and **All Referral Portals Access**.

## How a referral gets its portal

Every referral belongs to exactly one portal, and its payouts belong to the same portal. That's what decides which portal admins see it.

| How the referral starts | Its portal |
| - | - |
| Submitted on a referral portal | That portal |
| Through a referral link | The portal the link was made from |
| For a job req posted on exactly one portal | That portal |
| Added by your team, for a job req on several portals, or with no job req | You choose the portal in **Referral Portal** when you add it |
| Any other way | Your account's first active portal |

In bulk uploads, if some job reqs are on several portals, you choose one **Referral Portal** for those rows. See [The Referrals page](https://help.journeyfront.com/referrals/referrals-page.md).

### Move a referral to another portal

Open the referral, click **Edit**, and choose a new **Referral Portal**. The picker only appears if you can manage referrals and there's more than one portal to choose from. A portal admin can only move referrals between portals they manage. The referral's payouts move with it, and the change is recorded in its history. See [Referral details and milestones](https://help.journeyfront.com/referrals/referral-details.md).

## FAQ

> [accordion] Someone can't see the Payouts tab. Why?
>
> Their role doesn't have **Manage Referral Payouts**. Turn it on in their security role if they should see pay data.

> [accordion] Why can't I find the Referrals permissions on the Security page?
>
> The **Referrals** section only appears when Referrals is turned on for your account. Ask your Customer Success Manager.

> [accordion] A portal admin sees no referrals at all. What's wrong?
>
> Their role has **All Referral Portals Access** turned off, but they aren't listed as an admin on any portal yet. Add them under **Admins** on a portal's **General** tab.

> [accordion] Why can't someone be added as a portal admin?
>
> Only people whose role has **View Referrals** appear in the **Admins** list. Turn it on in their role first.

> [accordion] Why is there a lock on a reward program?
>
> The program is shared with portals you don't manage. Only someone who manages all of its portals can change it.

> [accordion] Can someone set up portals without full Company Settings access?
>
> Yes. **Manage Referral Settings** is enough to reach **Settings**, then **Referral Portals**, and to create and change reward programs.

## Related

> [card] [Security roles and permissions](https://help.journeyfront.com/account-setup/security-roles.md)
>
> Create roles and turn permissions on or off.

> [card] [Set up a referral portal](https://help.journeyfront.com/referrals/portal-setup.md)
>
> Create a portal and choose its admins.

> [card] [Reward programs](https://help.journeyfront.com/referrals/reward-programs.md)
>
> What a referral pays, and on which portals.

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


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