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

# Program Outcomes

> View aggregated, de-identified program-level outcome measures with HEDIS dashboard and small-n suppression.

The Program Outcomes screen displays aggregated outcome measures across programs for the current organization, accessible at `/cl/program-outcomes`.

## Overview

The page fetches program outcome records from `cl_program_outcomes` via `useProgramOutcomes`, with optional filtering by measure type. Outcomes with a denominator below the `outcome_small_n_suppression_threshold` (configurable in CL module settings, default 5) are automatically suppressed and displayed as dimmed rows with a "Suppressed — sample size too small" label rather than numerator/denominator/rate values. Four summary stat cards show: Total Measures, Average Rate, Meeting Benchmark count, and Suppressed count. A HEDIS Dashboard section renders below the summary cards. The main table columns are: Measure, Type, Period, Numerator, Denominator, Rate, Benchmark, and Status (Met / Not Met / N/A). A measure-type filter drop-down narrows the table. A warning alert appears if CL module settings fail to load (defaulting to threshold of 5).

## Who it's for

Requires permission: `cl.program_outcomes.view`

## Before you start

* Your account must have the `cl.program_outcomes.view` permission.
* CL module settings must be configured to set the suppression threshold (defaults to 5 if unavailable).

## Steps

<Steps>
  <Step title="Open Program Outcomes">
    Navigate to `/cl/program-outcomes`. Summary stat cards and the outcome table load automatically for the current organization.
  </Step>

  <Step title="Filter by measure type">
    Use the "All Types" drop-down in the top-right header to filter the table to a specific measure type.
  </Step>

  <Step title="Review the HEDIS dashboard">
    Scroll past the stat cards and separator to view the HEDIS Dashboard section.
  </Step>

  <Step title="Interpret suppressed rows">
    Rows with denominator below the suppression threshold appear dimmed with the label "Suppressed — sample size too small" in place of numeric values. The suppressed count appears in the stat card.
  </Step>
</Steps>

## Key concepts

<AccordionGroup>
  <Accordion title="Small-n suppression">
    Outcome rows where `denominator` is less than `outcome_small_n_suppression_threshold` are suppressed in the UI display. The threshold is read from `cl_module_settings.outcome_small_n_suppression_threshold` and defaults to 5.
  </Accordion>

  <Accordion title="Benchmark status">
    **Met** — `meets_benchmark` is `true`; **Not Met** — `meets_benchmark` is `false`; **N/A** — `meets_benchmark` is null.
  </Accordion>

  <Accordion title="Empty state">
    When no outcome data exists: "No Program Outcomes — No program-level outcome data has been recorded yet. Outcomes are generated from PROM entries and HEDIS calculations."
  </Accordion>

  <Accordion title="Settings warning">
    If `cl_module_settings` cannot be loaded, a warning alert reads: "Could not load CL module settings; using default suppression threshold. Some configuration may be unavailable."
  </Accordion>
</AccordionGroup>

## Related

<Columns cols={2}>
  <Card title="Clinical" icon="stethoscope" href="/cl/overview">
    Overview of the Clinical core.
  </Card>

  <Card title="Governance & parity" icon="scale-balanced" href="/governance/index">
    Documentation coverage and governance.
  </Card>
</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/cl.tsx
  * src/cores/cl/pages/ProgramOutcomesPage.tsx
  * src/cores/cl/hooks/useProgramOutcomes.ts
</Accordion>