Skip to main content
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

1

Open Departments

Navigate to HR → Departments or go to /hr/departments.
2

Search

Use the search box to filter departments by name.
3

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

Edit a department

Click the edit icon on a department card. Modify any fields and save.
5

Archive a department

Click the archive icon on a department card. Confirm the action in the archive dialog. The department is set to inactive.

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

Human Resources

Human Resources core overview.

Governance & parity

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