The Employees page (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/employees) is the organization-wide employee directory, providing search, filtering by status, department, and level, toggling between grid and list layouts, paginated results, and dialogs to add or bulk-import employees.
Overview
The Employee Directory shows up to 50 employees per page. Filters include a full-text search (name, title, email, or employee number), employment status (active by default), department, and employee level. A grid view shows avatar, name, title, department, level badge, email, and phone. A list view shows the same data in a tabular row. Export to CSV downloads the filtered set; bulk import accepts a CSV. Navigating to an employee card opens the employee detail page at/hr/employees/:id. The URL query parameter ?action=new automatically opens the add-employee dialog.
Who it’s for
Requires permission:hr.employees.view (HR_PERMISSIONS.EMPLOYEES_VIEW).
Before you start
- You need the
hr.employees.viewpermission to access this page. - To add employees, you need
hr.employees.create. - To export, you need
hr.employees.export.
Steps
- Navigate to HR → Employees or go to
/hr/employees. - Use the search box or filters to narrow the list.
- Toggle Grid or List to switch the display mode.
- Click an employee card or row to open the employee detail.
- Click Add Employee to open the new employee dialog.
- Click the upload icon to open the bulk import dialog.
- Click the download icon to export the current filtered list as CSV.
Key concepts
| Concept | Meaning |
|---|---|
| Employment status | Active, on_leave, or terminated — defaults to active on page load |
| Employee level | Picklist value from employee_levels; leadership levels show a star icon |
| Leadership badge | Displayed when level.metadata.is_leadership is true |
Related
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.
Documentation sources
Documentation sources
- src/routes/hr.tsx
- src/cores/hr/pages/EmployeeDirectory.tsx
- src/cores/hr/hooks/employees/useEmployeeList.ts