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

# Pathway Management

> Create and manage clinical care pathway definitions with steps, condition types, and active/inactive status.

The Pathway Management screen (`/cl/pathways`) is the admin registry for clinical pathway definitions — structured care protocols organized into sequential steps.

## Overview

The page loads all pathway definitions for the current organization from `cl_pathway_definitions` (soft-delete filtered). Each definition card displays `pathway_name`, `description`, `condition_type`, active/inactive status, and a step count badge. Clicking a card toggles an expanded view that renders the full `PathwayStepList`. Users with `cl.pathways.manage` see a "New Pathway" button in the header that opens a `CreatePathwayDialog`. An error alert using `sanitizeErrorMessage` surfaces any fetch failure. If no definitions exist, an empty state prompts creation.

## Who it's for

Requires permission: `cl.pathways.manage`

## Before you start

You must hold the `cl.pathways.manage` permission. The pathway list is scoped to your organization and will be empty until at least one definition is created.

## Steps

<Steps>
  <Step title="Navigate to /cl/pathways">
    Open the Clinical module and navigate to the Pathway Management page. The page loads pathway definitions for your organization.
  </Step>

  <Step title="Review existing pathways">
    Each pathway card shows its name, description, condition type, active/inactive status, and step count. Click a card to expand and view the step list.
  </Step>

  <Step title="Create a new pathway">
    Click "New Pathway" (visible to users with `cl.pathways.manage`) to open the Create Pathway dialog. Fill in the required fields and save.
  </Step>

  <Step title="Toggle expanded step view">
    Click any pathway card to show or hide its `PathwayStepList`. Click again to collapse.
  </Step>
</Steps>

## Key concepts

<AccordionGroup>
  <Accordion title="Empty state">
    When no pathway definitions exist for the organization, the page shows: "No pathways defined — Create a clinical pathway to provide structured care guidance."
  </Accordion>

  <Accordion title="Error state">
    If the data fetch fails, a destructive alert renders the sanitized error message above the pathway list.
  </Accordion>

  <Accordion title="Status badges">
    Each pathway card renders two badges: one for `condition_type` and one showing `Active` or `Inactive` based on the `is_active` field.
  </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/PathwayManagementPage.tsx
  * src/cores/cl/hooks/usePathways.ts
  * src/cores/cl/components/pathways/CreatePathwayDialog.tsx
  * src/cores/cl/components/pathways/PathwayStepList.tsx
</Accordion>