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

# HR Departments

> Create, edit, and archive organizational departments used across HR and workforce management.

The Departments page manages the organization's department structure. It is available at route `/hr/departments`.

## Overview

The page fetches departments via `useDepartmentList`. A search box filters the displayed list by name. Each department card shows the name, code, optional description, status badge (Active/Inactive), and an `is_clinical` indicator. Edit and archive actions appear on each card. The form dialog (create or edit) captures: name, code, description, is\_clinical flag, and is\_active flag. Creates use `createDepartment`, updates use `updateDepartment`.

## Who it's for

Requires permission `HR_PERMISSIONS.DEPARTMENTS_VIEW` (`hr.departments.view`). Edit/create actions require `HR_PERMISSIONS.DEPARTMENTS_ADMIN` (`hr.departments.admin`) — SME to confirm exact write permission.

## Before you start

* Department codes must be unique within the organization.
* Plan your department hierarchy before creating records, as departments are referenced throughout HR workflows.

## Steps

<Steps>
  <Step title="Open Departments">
    Navigate to **HR → Departments** or go to `/hr/departments`.
  </Step>

  <Step title="Search">
    Use the search box to filter departments by name.
  </Step>

  <Step title="Create a department">
    Click **+** (or the Add button) to open the form dialog. Enter name, code, description, and set the is\_clinical and is\_active flags.
  </Step>

  <Step title="Edit a department">
    Click the edit icon on a department card. Modify any fields and save.
  </Step>

  <Step title="Archive a department">
    Click the archive icon on a department card. Confirm the action in the archive dialog. The department is set to inactive.
  </Step>
</Steps>

## Key concepts

* **is\_clinical** — Flags the department as clinical; downstream effects (e.g., compliance requirements, credential checks) should be confirmed with SME.
* **is\_active** — Inactive departments are hidden from standard selection lists across the platform.

## 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/cores/hr/pages/Departments.tsx
  * src/cores/hr/hooks/employees/useDepartmentList.ts
</Accordion>