Overview
The ICD Matrix Selection feature allows users to define up to 12 ICD codes at the order level and then select applicable ones for each test using a matrix/grid of checkboxes. Once enabled, users cannot add more than 12 ICD codes at either the order or test level.
If existing orders have more than 12 ICDs, a small ‘+’ icon will show the number of extra ICD codes. These extra codes can be removed but cannot be replaced with new ones beyond the 12-code limit.
How to Configure
The setting can be enabled from the Registration Settings screen.
Setting Name: ICD Matrix Selection
Once enabled, the Billing and Order Update screens will display:
Up to 12 ICD code slots at the order level.
A matrix/grid for test-level ICD selection.
Users must select ICDs at the order level first, and then use the matrix to assign applicable ICDs to each test.
How It Works
When billing a patient or updating an order:
Users can add up to 12 ICD codes at the order level.
For each test in the order, users will see a grid layout where they can check one or more of the selected 12 ICDs.
If an order has existing ICDs exceeding 12 (from before enabling this setting), the system will show a small ‘+’ icon indicating the extra ICDs.
Users can choose to remove the extra ICDs if needed but cannot add new ICDs beyond the 12 allowed.
This ensures ICD selection is controlled, easy to manage, and consistent across all orders.
Important Points for Support Team
If the ICD Matrix Selection setting is disabled, the older multi-select method for ICDs will continue without changes.
If any issues are reported related to ICD selection, first check if the setting is enabled or not.
If customers complain about missing ICDs, check if they are trying to add more than 12 ICD codes, which is not allowed.
Share this help article link with customers if they need more clarification about how the feature works.
Limitations
If ICD Matrix Selection is enabled, Suggested ICD Codes and Pinned ICD Codes will not work for now.
Suggested ICDs (based on past orders) and pinned ICDs (manually pinned by the user) will be disabled when this feature is active.
This limitation is temporary. Support for suggested and pinned ICDs with matrix selection is planned for future releases.
If customers ask about missing suggestions or pinned ICDs, Support team should inform them about this limitation.
Technical/Implementation Details
The feature is applied on both the Billing screen and the Order Update screen.
Only 12 ICD slots are active; there is no option to add dynamic ICDs beyond these 12 slots.
Extra ICDs from old orders are shown visually through a ‘+’ icon. They can be deleted if needed but not replaced.