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

# Terminology Management

> Browse ICD-10 code hierarchies, manage medical code set versions, and configure cross-code-set mappings.

The Terminology Management page provides tools for navigating medical code hierarchies, managing code set versions, and configuring cross-code mappings. It is reached at `/settings/terminology`.

## Overview

The page is gated by `pf.codes.read` (route guard). It renders a three-tab interface:

* **ICD-10 Hierarchy** — `ICD10HierarchyNavigator` for browsing the ICD-10 code tree. Available to all users with `pf.codes.read`.
* **Code Set Versions** — `CodeSetVersionManager` for managing versioned code set releases. Only visible to users with `pf.codes.admin`.
* **Cross-Code Mappings** — `CodeMappingManager` for configuring equivalences between code systems. Available to all users with `pf.codes.read`.

The mapping lookup panel allows selecting a code set (default: ICD-10) and entering a code to search mappings.

## Who it's for

Requires `pf.codes.read` (route guard). The **Code Set Versions** tab additionally requires `pf.codes.admin`.

## Before you start

* No prerequisites for viewing the hierarchy or mappings.
* Configuring mappings or managing versions requires `pf.codes.admin`.

## Steps

1. Navigate to **Settings → Terminology** (`/settings/terminology`).
2. Use the **ICD-10 Hierarchy** tab to browse codes.
3. Use the **Cross-Code Mappings** tab to look up or manage code equivalences.
4. If you have `pf.codes.admin`, use the **Code Set Versions** tab to manage version releases.

## Key concepts

**Code set version** — a snapshot of a medical code system at a specific release date.

**Cross-code mapping** — a configured equivalence between codes in different code systems (e.g., ICD-10 → SNOMED).

## Related

<Columns cols={2}>
  <Card title="Platform Foundation" icon="layer-group" href="/pf/overview">
    Platform Foundation 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/platform.tsx
  * src/platform/terminology/pages/TerminologyManagementPage.tsx
  * src/platform/terminology/components/ICD10HierarchyNavigator.tsx
</Accordion>