Manage Mappings Between Conditions and HCC Codes

Salesforce provides the most current mappings between International Classification of Diseases (ICD) and Hierarchical Condition Category (HCC) codes. These codes are used to calculated patient risk for the Analytics for Health Cloud: Risk Scoring app. You can add or edit these mappings, but doing so can affect the accuracy of your results.

Available in: Lightning Experience

Available in: Enterprise and Unlimited Editions with Health Cloud


You can also download the most current information from the Centers for Medicare & Medicaid Services website. To replace or edit a delivered mapping, you must deselect the Active field and create another record.
  1. From the Health Cloud - Admin Home page, select the Condition to HCC Code Mapping tab, and click New.
  2. Enter the following:
    Field Description
    Mapping ID System-generated identifier for a specific mapping relationship.
    Condition Code The ICD code for a specific condition.
    HCC Code The CMS HCC code.
    Year + Condition + HCC Code Unique key for the record that links the Valid From field, the ICD condition code, and the HCC code.
    Valid From Number field that holds the year in which the HCC code became valid. For example, 2016.
    Valid Through The last year in which the HCC code was valid. For example, if a code was replaced in 2016, that’s the year that appears in the field. Codes that are being used and that are still valid don’t have a value in this field.
    Active Indicates whether this condition to HCC mapping is active and available for use.
  3. Save your work.