/hr/recruitment/referrals
📷 Screenshot: Employee Referrals list with the New Referral button — to be added.
Before you start
- Which business am I in? Referrals belong to the business selected in the switcher.
- The referrer must be an active employee. You can only log a referral against a current, active member of staff — the system rejects a referrer who isn’t active.
- One open referral per email. A non-cancelled referral already on file for an email address blocks a duplicate. Email is normalised (trimmed and lower-cased) so spacing or capitalisation can’t sneak a duplicate through.
- Each referral gets a reference number automatically (e.g.
REF-2026-0001).
The referral lifecycle (statuses)
A new referral starts as Pending. Converting it to an applicant moves it to In Process. You cannot edit a referral that is Cancelled or Rejected.
Logging a referral
Choose New Referral (needshr-recruitment:write).
📷 Screenshot: New Employee Referral dialog — to be added.
There are further fields the record can hold — an org unit, a CV attachment, a referral-bonus flag, a qualification reason, and work references — that round out the referral.
The referral bonus
A referral can be flagged as applicable for a referral bonus, and the record carries a referral payment status for tracking whether that bonus has been paid.⚠️ Current state: The referral-bonus flag and its payment status are recorded for tracking only — there is no automated bonus calculation or payout wired to them today. Treat the bonus as a manual, informational marker that HR/payroll action outside the referral screen. (Noted for awareness.)
Converting a referral into an applicant
When a Pending referral is worth pursuing, choose Convert to Applicant on its card (needshr-recruitment:write). This:
- Creates a job applicant from the referral’s name, email, and phone, with source set to “Employee Referral” and the source name set to the referrer (so the dashboard’s source-effectiveness chart can credit referrals as a channel).
- Flips the referral to In Process.
Searching & filtering
The list has a search box and a status filter (All statuses, Pending, In Process, Accepted, Rejected, Cancelled). Each card shows the candidate’s name and status, the reference number, who they were referred by, the role, and their contact details.Permissions
Related
- Job applicants — where a converted referral lands
- Applicant sources — how referrals are measured as a channel
- Interviews — interviewing a referred candidate
- Job offers — offering a referred candidate
- Recruitment overview & dashboard