> ## Documentation Index
> Fetch the complete documentation index at: https://docs.encoreos.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Job Postings

> Browse, create, and manage ATS job postings with status filtering and full detail including applications and scorecards.

The Job Postings page, at route `/hr/ats/job-postings` (alternate: `/hr/ats/jobs`), lists all job postings and lets you create new ones.

## Overview

The list supports grid (cards) and list views, switchable from the toolbar. Filters include a text search by title, a status filter (Draft, Published, Closed, Archived), and a department filter. Results are paginated with up to 20 postings per page. Selecting a posting card navigates to its detail page at `/hr/ats/job-postings/:id`. The alternate route `/hr/ats/jobs` also reaches this page.

## Who it's for

Access follows your organization's role and module configuration.

## Before you start

* Departments must be configured in HR before filtering by department.

## Steps

1. Go to **HR → ATS → Job Postings**.
2. Use the **search**, **status**, and **department** filters to find postings.
3. Toggle between **Grid** and **List** view with the toolbar buttons.
4. Select a posting to open its detail page.
5. To create a new posting, select **Create Posting** and complete the dialog.

## Key concepts

| Concept          | Meaning                                                                 |
| ---------------- | ----------------------------------------------------------------------- |
| Posting status   | Draft → Published → Closed → Archived.                                  |
| Grid / List view | Switchable display format; preference is not persisted across sessions. |

## Creating a job posting

New job postings are created via an action on the Job Postings list page at `/hr/ats/job-postings`. The path `/hr/ats/jobs/new` is referenced in the platform navigation label registry but has no registered `<Route>` in the HR router; direct navigation to that path may result in a 404. Creation may be handled at `/hr/ats/job-postings/new` or via a dialog action on the list page.

Before you start: confirm the position, department, and hiring manager details are available.

1. Navigate to `/hr/ats/job-postings`.
2. Use the available **Create Posting** action to create a new job posting.

## Viewing a job posting

The Job Posting Details page, at route `/hr/ats/job-postings/:id`, shows the full detail for a specific job posting, including applicant list and scorecard aggregates.

The page presents three tabs: **Overview** (posting details — title, department, location, salary range, dates), **Applications** (cards for each submitted application linked to applicant detail), and **Scorecards** (aggregated scorecard comparison across interviewers). Action buttons in the header let authorized users publish, close, edit, or archive the posting. The breadcrumb dynamically shows the posting title. Navigate to `/hr/ats/job-postings` to return to the list.

Before you start: the posting must already exist (created from the Job Postings list page). Scorecards require completed interviewer scorecard submissions for the posting.

1. Go to **HR → ATS → Job Postings** and select a posting.
2. Review the **Overview** tab for posting details.
3. Switch to **Applications** to see submitted candidates.
4. Switch to **Scorecards** to compare interviewer ratings.
5. Use the action buttons (**Publish**, **Close**, **Edit**, **Archive**) as appropriate.

**Key detail concepts:**

| Concept              | Meaning                                                      |
| -------------------- | ------------------------------------------------------------ |
| Posting status       | Draft → Published → Closed → Archived.                       |
| Scorecard comparison | Aggregated ratings across all interviewers for this posting. |

## Related

<Columns cols={2}>
  <Card title="Human Resources" icon="users" href="/hr/overview">
    Human Resources core overview.
  </Card>

  <Card title="Governance & parity" icon="scale-balanced" href="/governance/index" />
</Columns>

<Note>
  This page documents shipped product behavior. It is not medical, legal, or
  billing advice. Verify against your organization's policies and applicable
  regulations before using it for clinical, compliance, or billing decisions.
  Protected health information (PHI) shown in the product is governed by your
  tenant's access controls and is never exposed in this documentation.
</Note>

<Accordion title="Documentation sources">
  * src/routes/hr.tsx
  * src/platform/navigation/route-labels.ts
  * src/cores/hr/pages/ats/JobPostingListPage.tsx
  * src/cores/hr/pages/ats/JobPostingDetailPage.tsx
  * src/cores/hr/hooks/ats/useJobPostings.ts
  * src/cores/hr/hooks/ats/useJobPostingDetail.ts
  * src/cores/hr/hooks/ats/useJobPostingMutation.ts
</Accordion>