Job openings and the careers page

A job opening is the posting itself: the title, description and salary range a candidate reads, plus the dates that bracket the application window. It is also the record that collects applications, and the required-skills field on it is what the candidate match score is measured against.

Openings live at /job-openings. Creating and editing them needs hr.recruitment.manage.

How an opening becomes public

There is no separate publish action. The public careers pages read every opening whose status is Open, sorted with the most recently posted first, and nothing else. Setting an opening's status to Open — which is the default for a new record — is what makes it public; setting it to Closed or Filled removes it.

Three public pages serve them, all reachable without signing in:

Page	Route	What it shows
Careers index	/careers	Every Open opening, as a list of cards showing title, posted and closing dates, applicant count, and the salary range when publishing it is enabled
Job detail	/careers/{openingId}	The full description, plus an Apply Now button
Application form	/careers/{openingId}/apply	First Name, Last Name, Email, optional Phone and optional Cover Letter

The detail page returns "This position is no longer available" for an opening that is not Open, so closing a role takes down both the listing and its direct link. A Careers link in the marketing site footer points at /careers.

Note that the careers cards show a live applicant count for each role. If you would rather not advertise how many people have applied, that is not currently configurable.

The careers index requests one page of openings and does not paginate, so it shows at most the first 20 open roles by most recent posted date. That is ample for a normal hiring load, but it is worth knowing if you ever post more than twenty roles at once.

Create an opening

1. Open Job Openings from the Recruitment group.

2. Click New Opening.

3. Fill in the drawer:

   Field	Notes
   Job Title	Required. Appears publicly and in the internal grid.
   Description	Rich text. This is the body of the public posting.
   Required Skills	Comma-separated, e.g. Java, Spring Boot, PostgreSQL. Drives the applicant match score.
   Salary From (₱) / Salary To (₱)	Optional range.
   Publish salary range	Off by default. The range is only shown to candidates when this is on.
   Posted Date	Required, defaults to today.
   Closing Date	Optional. Leave blank for an open-ended posting.

4. Click Create Opening.

The opening is created with status Open, which means it is public from the moment you save it. If you want to draft a posting privately, create it and immediately set its status to Closed, then switch it back when you are ready.

Required Skills is worth filling in

The Required Skills list is the only input to the candidate match score. An opening with the field blank shows candidates no score at all — the applicant drawer says the opening has no required skills defined instead of reporting 0%. Skills are matched as whole comma-separated entries, case-insensitively, so keep them short and canonical.

Linking an opening to a requisition

The create and edit drawers do not have a requisition field. An opening can be linked to a requisition, but only through the CSV import, which accepts an optional requisitionId column holding the requisition's numeric ID. Openings created from the drawer stand alone.

Manage openings

The tab strip is All, Open, Closed and Filled with counts. Columns are ID, Title, Applicants, Status, Posted, Closing, Salary From and Salary To. Sorting works on ID, Applicants, Posted and Closing.

The Applicants column is maintained by the system: it increments whenever an applicant record is created against the opening, from the public form or from a recruiter's entry.

Row actions are View, Activity History, and — with manage permission — Edit, Status and Delete. Status opens a dialog offering Open, Closed and Filled; Filled is the one to use when the role has been taken, and Closed when the search ended without a hire. Nothing sets these automatically, including when a requisition's vacancies are all filled.

Selecting rows offers two bulk actions: Close Selected, which sets each selected opening to Closed, and Delete Selected.

Import openings from CSV

Table → Import CSV accepts the columns title, requisitionId, description, requiredSkills, salaryRangeFrom, salaryRangeTo, publishSalaryRange, postedDate and closingDate. publishSalaryRange is read as true only for the literal value true; requisitionId is optional, as noted above.

Imported openings are public as soon as they land, because they take the default Open status.

What candidates see

Only these fields reach the public pages: title, description, salary range (and only when Publish salary range is on), posted date, closing date, status and applicant count. The required skills you enter are not shown to candidates — they are used for scoring only.

Next step

Applications arriving against these openings show up on the applicants page. Continue with Applicants and screening.