HR Grievances

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:

​

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

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