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

# Org Chart

> Visualize the organizational hierarchy, search by name or title, expand or collapse reporting lines, and filter by department.

The Org Chart page displays the organizational reporting hierarchy and is available at `/hr/org-chart`.

## Overview

The Org Chart page (`OrgChart`) renders an interactive hierarchical view of the organization's reporting structure. Nodes display employee name and title. The page supports:

* Searching by employee name or title
* Filtering by department
* Expanding and collapsing individual nodes and their reporting chains

The org chart data is loaded via `useOrgChart` and `useDepartmentList`, and rendering behavior is influenced by HR module settings (`useHRModuleSettings`).

## Who it's for

Requires permission `hr.org-chart.view` (`HR_PERMISSIONS.ORG_CHART_VIEW`).

## Before you start

* Employee records and reporting relationships (manager assignments) must be configured for the org chart to display meaningful data.

## Steps

1. Navigate to `/hr/org-chart`.
2. Use the search field to find an employee by name or title.
3. Use the department filter to narrow the chart to a specific team.
4. Click expand/collapse chevrons to show or hide reporting chains.

## Key concepts

* **Org Chart Node** — A card representing a single employee, showing their name, title, and position within the reporting hierarchy.
* **Reporting Hierarchy** — The manager-to-direct-report relationships that determine the tree structure of the chart.

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