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

# Set up a referral portal

> Create a branded portal where employees refer people and share jobs, and get its link and QR code.

> [!NOTE]
>
> **Who can do this:** People whose security role has *Manage Referral Settings*. Without *All Referral Portals Access*, you only see and edit the portals you're an admin of.
>
> **Availability:** Referrals need to be turned on for your account. Ask your Customer Success Manager.

A referral portal is the page your employees use to refer people to your open jobs. Each portal has its own name, branding, sign-in rules, referral form and admins, so you can run one portal for the whole company or a separate one for each site or region.

This page covers creating a portal and its **General**, **Branding** and **Referral Form** settings. Sign-in is covered in [Employee sign-in and access](https://help.journeyfront.com/referrals/portal-access.md), and the **Notifications** and **Featured** sections in [Featured items and email notifications](https://help.journeyfront.com/referrals/featured-and-notifications.md).

## Create a portal

**1. Open Referral Portals**

Go to **Settings**, then **Referral Portals**. The list shows each portal's **Name**, **Status** (Active or Inactive), **Access**, **Admins** and **Last Updated**.

![The Referral Portals settings page listing two portals with their status, access and admins, with the New Referral Portal button highlighted](https://mintcdn.com/journeyfront/GQjKlyAQmW_Mi7NI/images/referrals/portal-setup/gen-list.png?fit=max\&auto=format\&n=GQjKlyAQmW_Mi7NI\&q=85\&s=e506f3aae0a544ff4307dc134dbaf217)

**2. Name the portal**

Click **New Referral Portal**, enter a **Name** and click **Create Referral Portal**. The portal opens in its editor.

**3. Work through the sections**

The editor lists its sections on the left: **General**, **Branding**, **Employee Access**, **Referral Form**, **Notifications** and **Featured**. Make your changes and click **Save** at the top. **Save** and **Cancel** appear as soon as something changes, and **Cancel** puts back the last saved version.

> [!TIP]
>
> You can switch between sections before saving. One **Save** keeps the changes from every section. If you try to leave the editor with unsaved changes, Journeyfront asks whether to **Save and Leave** or **Discard Changes**.

To edit a portal later, click its row. The menu at the end of each row also has **Edit Referral Portal**, **View Live Page** and **Delete Referral Portal**.

## General

![The General section of a referral portal's editor, with the General, Admins and Referrals cards and the section list on the left](https://mintcdn.com/journeyfront/GQjKlyAQmW_Mi7NI/images/referrals/portal-setup/gen-general.png?fit=max\&auto=format\&n=GQjKlyAQmW_Mi7NI\&q=85\&s=adbde42cee039ac5160fd3f92c7144bc)

| Setting | What it does |
| - | - |
| **Active** | Turns the portal on or off. Visitors can't use an inactive portal, and no one can sign in to it. |
| **Name** | The portal's name, shown to employees on the portal and in its emails. Required. |
| **Company Website** | Shown as a link at the bottom of the portal's menu. Leave it blank to hide the link. |
| **Admins** | The people who manage this portal's referrals, payouts, reward programs and settings. You can pick anyone whose role can view Referrals. |
| **Referral Source** | The source given to candidates created through this portal. **Default (Referral)** unless you pick another enabled source. |
| **Link Job Boards** | Which job boards (and their postings) employees can make referral links to from this portal: **All Job Boards** or **Specific Job Boards**. |

People whose role has **All Referral Portals Access** already manage every portal, so you only need to list admins who are limited to certain portals. See [Permissions and portal admins](https://help.journeyfront.com/referrals/permissions.md).

> [!TIP]
>
> Give each portal its own **Referral Source** when you run several portals. You can then compare where referred candidates came from in your source reporting.

The jobs a portal shows are your active job reqs that are set to show on all portals or on this one. You choose that on each job req. See [Rewards on job reqs](https://help.journeyfront.com/referrals/job-req-rewards.md).

## Share the portal

The **Sharing** card at the bottom of **General** gives you three ways to send people to the portal.

![The Sharing card with the referral portal link, a Refer a Friend intranet button with its code, and a QR code with Download PNG and Copy QR buttons](https://mintcdn.com/journeyfront/GQjKlyAQmW_Mi7NI/images/referrals/portal-setup/gen-sharing.png?fit=max\&auto=format\&n=GQjKlyAQmW_Mi7NI\&q=85\&s=578a5d8d88c6c1928406c1e4c52cba8c)

| Option | How to use it |
| - | - |
| **Referral Portal Link** | Copy the link to send in an email or chat. **View Live Page** opens the portal in a new tab. |
| **Intranet Button** | A **Refer a Friend** button in your brand color. Copy its code and paste it into your intranet or another web page. It opens the portal in a new tab. |
| **QR Code** | For posters and flyers. Scanning it opens the portal. Use **Download PNG** to save it or **Copy QR** to paste it into a document. |

The live page always shows the last saved version. While you have unsaved changes, **View Live Page** reminds you of that.

## Branding

Branding is a few simple choices. The portal's layout, fonts and spacing are already designed for you.

| Setting | What it does |
| - | - |
| **Logo** | Shown at the top of the portal's menu (the top bar on phones) and on its sign-in page. A wide image on a transparent background works best. |
| **Icon** | A square version of your logo for the collapsed menu and the browser tab. At least 128×128px. |
| **Brand Color** | Buttons and links use this color. Very light colors are darkened so text stays readable. |

Click **Upload Logo** or **Upload Icon** to add an image, **Replace Logo** or **Replace Icon** to change it, or the trash icon to remove it. The brand color is also used on the **Refer a Friend** intranet button and in the portal's emails.

> [!TIP]
>
> Upload an icon even if you have a logo. Without one, the collapsed menu shows your company's initials instead.

## Referral Form

These settings shape the form employees fill in when they refer someone.

![The Referral Form section with the Referral Form, Candidate Location and Consent cards](https://mintcdn.com/journeyfront/GQjKlyAQmW_Mi7NI/images/referrals/portal-setup/gen-form.png?fit=max\&auto=format\&n=GQjKlyAQmW_Mi7NI\&q=85\&s=4551e15aff5ea55612ba267c7466028d)

| Setting | What it does |
| - | - |
| **Require Candidate Phone** | Makes the candidate's phone number required instead of optional. |
| **Allow General Referrals** | Lets employees refer someone without choosing a specific job req. The candidate isn't contacted. The referral is recorded for your recruiters. |
| **Show Rewards** | Shows what each job req's reward program pays next to the job req. When it's off, the portal's **Rewards** page is hidden too. |
| **Country**, **Region/State**, **City** | Set each to **Hidden**, **Optional** or **Required**. Region/State options load from the chosen country, so it can't be more required than **Country**. |
| **Require Consent** | Employees must tick a box confirming they have the candidate's permission before they submit. |
| **Consent Text** | The statement they agree to. It appears when **Require Consent** is on. |

> [!TIP]
>
> Turn on **Require Consent** with text in your own words, especially where privacy rules apply. It gives you a record that every referred person agreed to be contacted.

## Run several portals

Create one portal per site, region or workforce when each needs its own look, sign-in rules or admins. For example, "Acme Careers" can require sign-in for your US staff while "Acme West" stays public.

Each portal shows the job reqs set to show on it, and each reward program can belong to all portals or to specific ones (see [Reward programs](https://help.journeyfront.com/referrals/reward-programs.md)). Portal admins only see the referrals, payouts and settings of their own portals.

## Delete a portal

Open the menu on the portal's row and click **Delete Referral Portal**, then **Delete**. This can't be undone. The portal's link stops working.

> [!TIP]
>
> To take a portal down for a while, turn off **Active** instead of deleting it. Its settings stay ready for when you turn it back on.

## FAQ

> [accordion] Can I embed the portal in our intranet?
>
> Use the **Intranet Button** on the **Sharing** card. Paste its code into your intranet page and it opens the portal in a new tab.

> [accordion] Why doesn't a job show on the portal?
>
> A portal only shows active job reqs that are set to show on all portals or on that portal. Check the job req's referral settings. See [Rewards on job reqs](https://help.journeyfront.com/referrals/job-req-rewards.md).

> [accordion] Why is Save grayed out?
>
> Something needs fixing first. Hover over **Save** to see what, for example a missing name on the **General** section.

> [accordion] Who can I make a portal admin?
>
> Anyone in your account whose security role can view Referrals. Admins without **All Referral Portals Access** work only with the portals they're listed on.

> [accordion] I created a portal but I'm not on the Admins list. Will I lose access?
>
> No. If your role is limited to certain portals, Journeyfront adds you as an admin of any portal you create.

> [accordion] Do my Featured changes need Save?
>
> No. Featured items save as soon as you make each change. Everything else in the editor saves with **Save**.

## Related

> [card] [Employee sign-in and access](https://help.journeyfront.com/referrals/portal-access.md)
>
> Who can sign in, what they see and what happens when someone leaves.

> [card] [Featured items and email notifications](https://help.journeyfront.com/referrals/featured-and-notifications.md)
>
> Promote jobs and news, and choose which emails employees get.

> [card] [Permissions and portal admins](https://help.journeyfront.com/referrals/permissions.md)
>
> The referral permissions and how portal admins work.

> [card] [Using the referral portal](https://help.journeyfront.com/referrals/employee-portal.md)
>
> What your employees see and do on the portal.


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