Skip to content
Back to Blog
March 18, 2026·7 min read

ICD-10-CM HCC Mapping Tool: What Every HCC Coder Needs in 2026

Discover what an HCC mapping tool actually does, why the ICD-10 HCC crosswalk matters more than ever in the 2026 V28-dominant blend year, and how HCC Buddy gives you instant results inside your browser.

HCC Mapping ToolICD-10 HCC CrosswalkRisk AdjustmentHCC Coding

By Daniel Plasencia — Certified Risk Coder (CRC), Certified Professional Coder (CPC)
Reviewed: March 18, 2026

ICD-10-CM HCC Mapping Tool: What Every HCC Coder Needs in 2026

An HCC mapping tool is software that translates an ICD-10-CM diagnosis code into its Hierarchical Condition Category (HCC) assignment — instantly, without requiring a coder to open a CMS PDF or maintain a personal spreadsheet. If you review Medicare Advantage charts in 2026, you need an HCC mapping tool because the ICD-10 HCC crosswalk has changed significantly with the V28 model rollout and the 2026 payment year uses a 33% V24 / 67% V28 blend. Knowing which model applies to which code — and at what weight — is no longer something you can reliably track by memory alone.

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 72,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:

  • Instant code lookup with inline HCC result — Type the ICD-10-CM code and see the HCC assignment immediately, without clicking through multiple screens
  • Both V24 and V28 mappings shown simultaneously — During the 2026 blend period (33% V24 / 67% V28), a coder needs to see both model assignments at a glance, not toggle between views
  • Risk Adjustment Factor weight per model — The weight determines the actual reimbursement impact; a good tool shows the coefficient alongside the HCC number
  • Excludes 1 and Excludes 2 notes visible — ICD-10-CM combination coding constraints affect HCC assignment; missing an Excludes note can result in incorrect code combinations being submitted
  • Works inside the browser without switching applications — A Chrome extension or embedded widget keeps the coder in the electronic health record tab while providing lookup results in a side panel or popup
  • 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

    The ICD-10 HCC crosswalk is updated annually by CMS as part of the Medicare Advantage payment system. For each payment year, CMS publishes a mapping file that assigns each HCC-relevant ICD-10-CM code to one or more HCC categories under each model. The 2026 crosswalk is especially important because it governs the first payment year in which V28 carries a majority weight (67%) in the blend calculation.

    A few specific examples illustrate why coders cannot rely on memory or prior-year knowledge:

  • E11.22 (Type 2 Diabetes Mellitus with diabetic chronic kidney disease) maps to HCC 37 in V28. This is a high-weight HCC representing diabetes with chronic complications.
  • I48.0 (Paroxysmal atrial fibrillation) maps to HCC 238 in V28 — the cardiac arrhythmias category. Coders who memorized the V24 assignment for atrial fibrillation may note that HCC assignments shifted across model versions.
  • I10 (Essential hypertension) does not map to an HCC in either V24 or V28. Hypertension alone is not HCC-relevant; it must be linked to a complication (hypertensive heart disease, hypertensive chronic kidney disease) for an HCC assignment to apply.
  • Z68.30 through Z68.39 (Body Mass Index codes) are not HCC-relevant. Documenting and coding obesity-related Body Mass Index codes supports clinical completeness but does not contribute to the Risk Adjustment Factor score.
  • 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, the result screen shows:

  • HCC badge for V28 — displayed in navy, showing the HCC number and category name
  • HCC badge for V24 — displayed in slate, for comparison during the blend period
  • Risk Adjustment Factor weight for each model — the coefficient displayed numerically so coders can see the reimbursement impact
  • Billable indicator — color-coded to confirm the code is valid for the current code year
  • Excludes 1 and Excludes 2 notes — pulled from the official ICD-10-CM tabular and shown inline so coders never have to cross-reference a separate coding manual
  • 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?

    Yes. The ICD-10 HCC crosswalk is a federal standard published by CMS and applies uniformly to all Medicare Advantage plans. Individual plans do not have their own mapping files; all plans use the same V24 and V28 model assignments for each payment year. What varies between plans is how they conduct internal risk adjustment audits and prospective coding reviews, but the underlying crosswalk is identical.

    Do I need a separate tool for V24 and V28?

    No. A well-designed HCC mapping tool displays both model assignments simultaneously. During the 2026 blend year, seeing V24 and V28 results side by side is more useful than consulting them separately, because the Risk Adjustment Factor impact is calculated as a weighted combination of both. Any tool that forces you to toggle between models or run two separate searches adds unnecessary steps.

    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.

    Daniel Plasencia

    Daniel Plasencia

    Founder & Developer

    Daniel Plasencia — Risk adjustment coding professional and software engineer who built the tool he wished existed, at a price coders can actually afford.

    Get HCC Coding Tips in Your Inbox

    Join our newsletter for coding tips, guideline updates, and tool announcements.

    Related Articles