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

# Career Paths

> View and create career path definitions showing from/to position transitions and path types.

Career Paths is available at route `/hr/succession/career-paths`. Access follows your organization's role and module configuration. ## Overview

The Career Paths list page shows all active career path definitions as a data table. Each row displays the from-position title, to-position title, path type (rendered as a badge using `PATH_TYPE_LABELS`), and typical duration in months. A **New Path** button opens a dialog containing the `CareerPathForm` for creating a new career path. The list is filtered to `isActive: true` from the `useCareerPathList` hook.

## Who it's for

Access follows your organization's role and module configuration. ## Before you start

* Position records must exist to be selectable in the career path form.

## Steps

<Steps>
  <Step title="Open Career Paths">Navigate to `/hr/succession/career-paths`.</Step>
  <Step title="Review existing paths">Browse from-position to to-position transitions and their types and durations.</Step>
  <Step title="Create a path">Click **New Path**, complete the `CareerPathForm` in the dialog, and submit.</Step>
</Steps>

## Key concepts

| Term                      | Meaning in code                                                  |
| ------------------------- | ---------------------------------------------------------------- |
| `CareerPathType`          | Enumerated path type values from `src/cores/hr/succession/types` |
| `PATH_TYPE_LABELS`        | Display labels for each `CareerPathType` value                   |
| `typical_duration_months` | Optional expected transition duration; rendered as "N months"    |

## 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">
    Documentation coverage and governance.
  </Card>
</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/routes/hr/oversight-analytics-succession-routes.tsx
  * src/cores/hr/succession/pages/CareerPathListPage.tsx
  * src/cores/hr/succession/hooks/useCareerPathList.ts
  * src/cores/hr/succession/types/index.ts
</Accordion>