ICD-10-CM HCC Mapping Tool: What Every HCC Coder Needs in 2026
See what an HCC mapping tool does, why the ICD-10-CM crosswalk changed for CY2026 non-PACE payment, and how to verify a code against the current V28 source.
By the HCC Buddy Coding Team
Updated: August 25, 2026

An HCC mapping tool translates an ICD-10-CM diagnosis code into its source-listed Hierarchical Condition Category (HCC) assignment. If you review Medicare Advantage charts in 2026, check the program and payment year before using the result. CY2026 non-PACE risk scores use V28 at full weight, while PACE uses a separate blend. The historical V24 reference still matters for prior-year review.
Why Manual HCC Mapping Wastes Coding Time
CMS publishes the official ICD-10 HCC crosswalk as part of the annual Rate Announcement package on the CMS risk-adjustment model software and ICD-10 mappings page. In practice, that means a 300-plus page PDF or a downloaded Excel file that coders save locally and search through while reviewing charts.
The problem is context switching. A coder reviewing a chart in an electronic health record has to stop, open a separate tab or application, search the spreadsheet, find the code, read across to the HCC column, note the model (V24 or V28), go back to the chart, and continue, for every diagnosis code that might be HCC-relevant. At 10 to 20 codes per chart and dozens of charts per day, that friction adds up to a significant portion of the coding shift.
Of the approximately 74,000 ICD-10-CM codes in the current code set, only a subset map to HCCs. But that subset includes codes for the most common chronic conditions seen in Medicare Advantage populations, diabetes, heart failure, chronic kidney disease, chronic obstructive pulmonary disease, atrial fibrillation, and dozens of others. Missing or miscoding even one of these conditions in a chart review session can affect the patient's Risk Adjustment Factor score and the plan's reimbursement.
The right HCC mapping tool eliminates the context-switch entirely.
What an HCC Mapping Tool Should Do
Not all tools marketed as HCC coding tools actually perform mapping. A genuine HCC mapping tool should provide the following without requiring any navigation away from the chart:
Anything that requires a coder to leave the chart, open a new application, or maintain a local file fails on the most important criterion: speed inside the workflow.
The ICD-10 HCC Crosswalk in 2026
CMS publishes annual ICD-10-CM mapping files for Medicare Advantage risk adjustment. The current 2026 Final file contains generic CMS-HCC V28, ESRD V21/V24, and RxHCC V08 columns. It does not contain a generic CMS-HCC V24 column. HCC Buddy's historical generic V24 reference comes from the CMS 2025 Midyear/Final file, which labels that column for PY2025.
A few specific examples illustrate why coders cannot rely on memory or prior-year knowledge:
The crosswalk also changes within the same code category across payment years as CMS refines the model. For a deeper walkthrough of how the mapping works mechanically, see ICD-10 to HCC Mapping: How It Works.
How HCC Buddy Works as an HCC Mapping Tool
HCC Buddy is a Chrome extension that provides ICD-10 HCC crosswalk results directly inside any electronic health record tab. When a coder searches a code in the HCC Buddy encoder, part of the wider HCC coding software toolkit, the result screen shows:
The extension installs in Chrome and works as a side panel or popup inside whatever electronic health record system the coder uses, Epic, Veradigm, Athena, or any browser-based platform. There is no separate application to open, no spreadsheet to maintain, and no tab switching required.
Frequently Asked Questions About HCC Mapping Tools
Is the CMS-HCC crosswalk the same for all Medicare Advantage plans?
CMS publishes the model mapping files used for Medicare Advantage risk adjustment. The applicable model and blend still depend on the program and payment year. CY2026 non-PACE risk scores use V28 at full weight, while PACE follows a separate blend. Historical V24 results must be tied to the official source for the year under review.
Do I need a separate tool for historical V24 and current V28?
No. A useful HCC mapping tool can show current V28 and a clearly labeled historical V24 reference together. The V24 result helps with prior-year review, but it must come from the source for that payment year. CY2026 non-PACE payment uses V28 at full weight.
Can I use a spreadsheet instead of a dedicated tool?
You can, but it is slower. A downloaded CMS crosswalk file in Excel can answer the question "what HCC does this code map to?", but it requires you to leave the chart, open the file, search by code, and navigate back. A dedicated HCC mapping tool inside the browser provides the same answer without any of those steps. For coders reviewing 20 or more charts per day, that difference compounds into significant time savings per shift.
How often is the HCC mapping updated?
CMS updates the ICD-10 HCC crosswalk annually, timed to each payment year. Mapping files for the upcoming payment year are typically released as part of the Rate Announcement in the spring of the prior year. Coders should verify that any tool or spreadsheet they use reflects the current payment year's crosswalk, not a prior year's file.
HCC Buddy's encoder gives you instant ICD-10 HCC crosswalk results right in your browser, no spreadsheets, no tab switching. Try it free at hccbuddy.com or see how it compares to Codify and other tools HCC coders use at hccbuddy.com/crc.
Related Tools
HCC Buddy Coding Team
Editorial
Every HCC Buddy article is checked against the current CMS-HCC model and the active FY ICD-10-CM tabular release before it publishes.
Get HCC Coding Tips in Your Inbox
Join our newsletter for coding tips, guideline updates, and tool announcements.




