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

> View and manage all employee grievances — filter by type and status, file new grievances, view full grievance detail with documents, and edit grievance records.

The Grievances page (`/hr/employee-relations/grievances`) lists all employee grievances with filtering by type and status, and navigation to file new grievances or view existing ones.

## Overview

The page shows a search input, grievance type filter, and status filter. Results render as card rows with grievance type icon, filing date, status badge, and a link to the detail page. Grievance types available in the list filter: Harassment, Discrimination, Wage Dispute, Working Conditions, Other. Status values: filed, under\_investigation, resolved, dismissed, escalated. A **File Grievance** button navigates to `/hr/employee-relations/grievances/new`. Each row links to `/hr/employee-relations/grievances/:id`.

## Who it's for

Access follows your organization's role and module configuration.

## Before you start

* Grievance records are created via the File Grievance form.

## Steps

1. Navigate to **HR → Employee Relations → Grievances** or go to `/hr/employee-relations/grievances`.
2. Use the type and status filters to narrow results.
3. Click a grievance row to view the full detail.
4. Click **File Grievance** to submit a new grievance.

## Viewing a grievance

The Grievance Details page (`/hr/employee-relations/grievances/:id`) displays the full record for a single employee grievance, including type, status, narrative, and documents, with an option to edit the grievance.

The page uses `useGrievanceDetail` to load the grievance by `:id` and sets a breadcrumb to the grievance type label. A status badge and an **Edit** button are shown in the page header. The page is organized into tabs (using `ScrollableTabsList`) to separate the overview, documents (`CaseDocuments`), and any additional sections. Grievance type is displayed as a human-readable label (e.g., "Wage Dispute"). Status values include: filed, under\_review, under\_investigation, resolved, dismissed, escalated.

Before you start: the grievance record must exist in your organization.

1. Navigate to **HR → Employee Relations → Grievances** and click a grievance row, or go to `/hr/employee-relations/grievances/:id`.
2. Review the type, status, and summary information.
3. Switch tabs to view associated documents.
4. Click **Edit** to update the grievance details or change the status.

**Key detail concepts:**

| Concept            | Meaning                                                                  |
| ------------------ | ------------------------------------------------------------------------ |
| Grievance type     | Category of the complaint (e.g., harassment, wage\_dispute)              |
| Status `escalated` | Grievance moved to a higher authority — SME: confirm escalation workflow |

## Editing a grievance

The Edit Grievance page provides a form for updating an existing grievance record. It is available at route `/hr/employee-relations/grievances/:id/edit`. The route renders `GrievanceFormPage` in edit mode (because the `id` param is present). The existing record is fetched via `useGrievanceDetail`. On submit, `updateMutation` is called and the user is redirected to the grievance detail page. The form normalizes `grievance_type` and `status` values against known valid sets before submitting.

Valid grievance types from code: `harassment`, `discrimination`, `retaliation`, `wage_dispute`, `working_conditions`, `policy_violation`, `other`. Valid statuses: `filed`, `under_review`, `under_investigation`, `resolved`, `dismissed`, `escalated`.

Component-level permission checks apply for write actions.

Before you start: navigate from a grievance detail page at `/hr/employee-relations/grievances/:id`.

1. From a grievance detail page, click the edit action. You land on `/hr/employee-relations/grievances/:id/edit`.
2. Update type, status, description, or other fields.
3. Submit the form. On success, you are redirected to the detail page.

## 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/employee-relations-routes.tsx
  * src/cores/hr/employee-relations/pages/GrievanceListPage.tsx
  * src/cores/hr/employee-relations/pages/GrievanceDetailPage.tsx
  * src/cores/hr/employee-relations/pages/GrievanceFormPage.tsx
  * src/cores/hr/employee-relations/hooks/useGrievanceList.ts
  * src/cores/hr/employee-relations/hooks/useGrievanceDetail.ts
  * src/cores/hr/employee-relations/hooks/useGrievanceMutation.ts
</Accordion>