Search Knowledge Base Articles

Recruitment Portal — User Guide

Recruitment Portal — User Guide

Module: Recruitment
Audience: Job seekers, candidates, recruiters (admin link)
Version: 1.0.0
Last updated: 2026-07-22

Overview

The recruitment portal is your organisation's public job board. Candidates can search open roles, view job details, apply online, and (when logged in) manage their profile and applications. Recruiters open the same URL from Recruitment → Recruitment portal in the admin sidebar.

Only campaigns marked In progress appear on the portal.

Prerequisites

  • At least one campaign in In progress status.
  • Optional: a recruitment channel web form assigned to the campaign (for Apply now).
  • Optional: candidate self-registration enabled (allow_registration in system settings).

Step-by-step: Browse jobs (public)

  1. Open the portal URL (from Recruitment → Recruitment portal or your site's public link).
  2. Use the search bar to find roles by keyword (title, position, location, company, etc.).
  3. Click a job title to open the detail page.

Expected result: A list of active openings with company name, work type, and location. Search results show a count heading.

Step-by-step: View job details and apply

  1. On the job detail page, review role, dates, salary (if displayed), position, and company information.
  2. If Apply now is shown, click it to open the web application form (may open in a new tab).
  3. Optionally click Email to friend to share the role.

Expected result: Apply opens the recruitment channel form. Expired campaigns (past end date) hide the apply button.

Step-by-step: Candidate login and registration

  1. From the portal navigation, click Login.
  2. Enter email and password. Complete reCAPTCHA if prompted.
  3. To register (when enabled), click Register and complete the sign-up form.

Expected result: After login you return to the portal home page with a profile menu in the navigation bar.

Step-by-step: Candidate profile menu (logged in)

When logged in, the profile dropdown offers:

  • Profile — edit personal information
  • GDPR — privacy rights (when GDPR is enabled)
  • Applied jobs — track submitted applications
  • Interview schedules — view scheduled interviews
  • Logout

Note: Several of these links currently return errors because the portal controller does not yet expose those routes. See common issues below.

Common issues

Symptom Likely cause What to do
No jobs listed No campaigns in In progress status Update campaign status in admin
No Apply now button No recruitment channel form or campaign expired Edit campaign; assign channel; check end date
Apply now goes nowhere Channel form not configured Set up form under Recruitment → Recruitment channel
Profile / Applied jobs / Interviews 404 Known missing portal routes Use admin Candidate profile until routes are implemented
Cannot register Registration disabled Ask admin to enable allow_registration
Salary not shown Display salary unchecked on campaign Edit campaign and enable display

Related features

  • Recruitment → Campaign — controls which jobs appear (status must be In progress)
  • Recruitment → Recruitment channel — web apply forms linked from job detail
  • Recruitment → Candidate profile — admin-side candidate management
  • Recruitment → Interview schedule — schedules interviews (portal view pending route fix)

Did you find this article useful?

Related Articles