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

# Credential Analytics

> Compliance trend charts, expiration forecasts, and department comparisons for employee credentials.

The Credential Analytics page surfaces compliance trends, expiration forecasts, and department-level comparisons for employee credentials. It is available at route `/hr/credentialing/analytics`.

## Overview

This route redirects to `/hr/credentialing?tab=analytics`. The Analytics tab within the Credentialing Hub renders `CredentialAnalyticsPage`, which uses `useCredentialAnalytics` to show four KPI cards: Current Compliance (%), Monthly Change (%), Expiring in 90 Days (count), and Average Days to Renewal. Below the KPIs, four chart components render: `ComplianceTrendChart`, `CredentialTypeDistributionChart`, `ExpirationForecastChart`, and `DepartmentComplianceTable`.

## Who it's for

Requires permission `HR_PERMISSIONS.CREDENTIALS_VIEW` (`hr.credentials.view`) — inherited from the Credentialing Hub route wrapper.

## Before you start

* Credential records must exist in the system with expiration dates set.
* Navigate to `/hr/credentialing` and select the **Analytics** tab, or use the direct redirect at `/hr/credentialing/analytics`.

## Steps

<Steps>
  <Step title="Navigate to Credentialing Analytics">
    Go to **HR → Credentialing** and select the **Analytics** tab. Or navigate directly to `/hr/credentialing/analytics` (you will be redirected to the hub with the analytics tab active).
  </Step>

  <Step title="Review KPI cards">
    Check Current Compliance %, Monthly Change %, expiring credentials count, and average days to renewal at the top of the page.
  </Step>

  <Step title="Analyze trends and forecasts">
    Review the Compliance Trend Chart for historical trends, the Type Distribution chart for credential mix, and the Expiration Forecast chart for upcoming expirations.
  </Step>

  <Step title="Compare departments">
    The Department Compliance table shows compliance rate per department to identify areas needing attention.
  </Step>
</Steps>

## Key concepts

* **Compliance rate** — Derived by `useCredentialAnalytics`; exact calculation should be confirmed with SME.
* **Expiring (90d)** — Credentials with expiration dates within 90 days from today. SME should confirm if this window is configurable.

## 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/CredentialAnalyticsPage.tsx
  * src/cores/hr/pages/CredentialingHubPage.tsx
</Accordion>
