> ## 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 Cost Reports

> Analyze compensation costs aggregated by department or employee with CSV export.

The Cost Reports page shows compensation costs aggregated by department or by individual employee with an Export CSV option. It is available at route `/hr/compensation/cost-reports`.

## Overview

The page offers two Group By options — **Department** and **Employee**. When grouped by Department, a headcount column is included. When grouped by Employee, a Department Filter dropdown appears. Four summary stat cards show Total Headcount, Total Base Salary, Total Benefits, and Total Compensation. The data table columns are: Name, (Headcount for department view), Base Salary, Benefits, Bonuses, Retirement, Total Cost. The Export CSV button downloads a `.csv` file named `compensation-cost-report-<groupBy>-<date>.csv`.

## Who it's for

Access follows your organization's role and module configuration. Any authenticated user who can reach `/hr/compensation/cost-reports` will see the page.

## Before you start

* Compensation data must be populated for the organization.
* Department records must exist if filtering by department when grouped by Employee.

## Steps

<Steps>
  <Step title="Open Cost Reports">
    Navigate to **HR → Compensation → Cost Reports** or go to `/hr/compensation/cost-reports`.
  </Step>

  <Step title="Select Group By">
    Choose **Department** to see aggregated costs per department with headcount, or **Employee** to see individual-level cost rows.
  </Step>

  <Step title="Apply Department Filter (Employee view only)">
    When grouped by Employee, use the Department Filter dropdown to scope results to a specific department.
  </Step>

  <Step title="Review summary cards">
    The four stat cards at the top show organization-level totals.
  </Step>

  <Step title="Export to CSV">
    Click **Export CSV** to download the current view as a comma-separated file.
  </Step>
</Steps>

## Key concepts

* **Group By** — Controls both the table structure (headcount column, department vs. employee name) and the CSV export column layout.

## 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/compensation/pages/CompensationCostReportsPage.tsx
  * src/cores/hr/compensation/hooks/useCompensationCostReport.ts
</Accordion>