Skip to main content

Medical Coding Overview

# Medical Coding
Last updated: 04/14/2026

Use the Medical Coding app to review, search, and assign standardized medical codes to verbatim terms collected in CRFs, and manage reusable aliases for recurring terms.

Overview

Medical Coding is the study-level workspace for standardizing verbatim terms collected in CRFs against medical dictionaries such as MedDRA. It provides a centralized interface to review, search, and assign standardized codes to subject data entries, and to manage reusable aliases for recurring terms.

The app is organized into two sections accessible from the top navigation:

  • Medical Coding — Review and code verbatim terms submitted across subjects
  • Alias Management — Manage reusable verbatim-to-code mappings for auto-coding

Direct URL patterns:

https://[instance]/study/[studyId]/apps/medical-coding
https://[instance]/study/[studyId]/apps/medical-coding/alias-management

Replace [instance] with your environment host (for example, test-2025.clinicaldatas.net) and [studyId] with the study identifier.

Who uses this screen

Users responsible for medical coding — typically data managers or designated medical coders — need the appropriate study role and permissions. If you cannot access Medical Coding or certain records, ask your study administrator to confirm your access.

Typical workflow

  1. Open the study and navigate to Medical Coding in the top navigation bar.
  2. Review the summary stats bar to understand the current coding status across all entries.
  3. Use the filter pills (Total, Not Coded, Code Not Found) to focus on records that need attention.
  4. For each unresolved row, click Search code to open the code search dialog, find the correct preferred term, and assign it.
  5. Use Auto code to automatically match all remaining unresolved terms against the configured dictionary.
  6. Optionally, navigate to Alias Management to review or create reusable verbatim-to-code mappings.
  7. To review source data verification alongside coding, use All Tasks → SDV in the top navigation to open the SDV workspace.

Accessing Medical Coding

From within the study, Medical Coding appears in the top navigation bar alongside other apps. You can also use the All Tasks dropdown (available in the top navigation bar) to jump to Medical Coding or to navigate to related features such as SDV.

Medical Coding main page showing the coding table and summary stats bar

In the navigation bar:

  • MEDICAL CODING — Main verbatim coding workspace (active tab shown above)
  • ALIAS MANAGEMENT — Reusable verbatim-to-code mapping store
  • ALL TASKS — Dropdown showing all study app areas; SDV is listed under Data Compliance

Medical Coding workspace (observed)

Summary stats and filter pills

At the top of the Medical Coding page, a row of filter pills shows the current coding status across all entries. Each pill is clickable and filters the table to that status.

Medical Coding toolbar showing summary stats, Auto code button, and Export as button

PillDescription
TotalAll verbatim terms in the study (active/selected by default)
CodedTerms that have been successfully assigned a medical code
Not CodedTerms that have not yet been coded
Code Not FoundTerms where a search was performed but no matching code was found
LockedTerms that are locked and cannot be edited

Top-level controls visible on the screen:

  • Search — Filter the table by verbatim term, subject ID, event, CRF, or item name
  • Auto code — Automatically attempt to match all unresolved terms against the configured dictionary
  • Export as — Download the coding data including all verbatim terms and their current coding status

Coding table

The main table lists all verbatim terms submitted across subjects. In the observed study, the table shows the following columns:

Medical Coding table showing columns: Verbatim term, Dictionary, Status, Subject ID, Event, CRF, Item, Medical codes, Action

ColumnDescription
Verbatim termThe raw text entered by the data entry user on the CRF
DictionaryThe medical dictionary used for coding (e.g., MedDRA)
StatusCurrent coding status: Not Coded, Coded, Code Not Found, or Locked
Subject IDThe ID of the subject who submitted the term (clickable)
EventThe study event associated with the CRF entry
CRFThe name of the CRF form where the term was entered
ItemThe specific CRF item (field) that captured the term
Medical codesThe assigned medical code(s), once coded
ActionAvailable row-level actions (see below)

Row actions

ActionAvailable whenDescription
Search codeStatus is Not Coded or Code Not FoundOpens the code search dialog to find and assign a medical code
View in CRFAlwaysOpens the source CRF entry for the subject to view the data in context

Search Code dialog

Clicking Search code on a row opens a dialog where you can:

  1. Search by keyword — the verbatim term is pre-filled in the search box
  2. Browse the Preferred Name results returned from the configured dictionary
  3. Select a result to assign it as the medical code for the term

Auto code

Click Auto code in the toolbar to automatically attempt to match all unresolved verbatim terms against the configured dictionary. Terms with exact or high-confidence matches are coded automatically. Terms that cannot be matched are marked as Code Not Found.

All Tasks — navigating to SDV

The All Tasks dropdown in the top navigation bar provides access to all study workspaces from within Medical Coding, including the SDV app.

All Tasks dropdown open, showing SDV under Data Compliance section

To navigate to SDV from Medical Coding:

  1. Click All Tasks in the top navigation bar.
  2. Under Data Compliance, click SDV.
  3. The SDV workspace opens, showing View by CRF and View by Subject tabs.

SDV and Medical Coding work together — verbatim terms coded in Medical Coding are often linked to CRFs that are also subject to source data verification.

Alias Management workspace (observed)

Click Alias Management in the top navigation bar to open the alias store.

Alias Management page showing the alias table columns

Alias Management stores mappings between verbatim terms and their preferred medical codes. Once an alias is created, future occurrences of the same verbatim term can be auto-coded using the saved mapping.

The alias table shows the following columns:

ColumnDescription
Verbatim termThe raw term as entered in the CRF
External DictionaryThe external medical dictionary the alias maps to (e.g., MedDRA)
Custom DictionaryA custom/internal dictionary mapping, if applicable
Created OnDate the alias was created
Created ByUser who created the alias
Last Updated OnDate the alias was last modified
Preferred nameThe standardized preferred term assigned to this verbatim term
URLReference URL for the assigned code in the dictionary
ActionEdit or delete the alias

Top-level controls on the Alias Management page:

  • Search — Filter aliases by verbatim term or preferred name
  • Export as — Download the full alias list

Note: Auto code is not available on the Alias Management page. Use it from the main Medical Coding workspace.

Relationship to configuration

What dictionaries are available, how auto-coding behaves, and which study accounts are linked are all driven by settings under Medical Coding configuration. If expected dictionaries do not appear or auto-code does not produce results, verify that the dictionary and account are configured correctly.

  • Medical Coding configuration — Dictionary setup, auto-code settings, and account configuration
  • SDV Events — Source data verification organized by study event; accessible from Medical Coding via All Tasks → SDV