Use this area to maintain the diagnosis systems your workspace relies on. This page is for the catalogue itself, not for recording a diagnosis on a patient.
Where to find it
Open Settings → Workflow → Diagnosis systems.
From there you can:
- review the systems available in your workspace
- choose the catalogue year for systems that publish yearly versions
- add a new code system
- open a system and manage its individual codes
What a diagnosis system is
A diagnosis system is a catalogue such as:
- an internal Circle catalogue
- a standardized catalogue such as ICD-10-GM
Each system has its own list of codes. A workspace can use more than one system at the same time.
Choosing the catalogue year
Some systems expose multiple versions, usually by year.
On the main Diagnosis systems page you can choose which year to use for a system. If a system does not publish versions, circleOS shows No versions available instead of a year picker. You can also leave the picker on All years.
Use this when you need to:
- move to a new coding year
- keep a workspace on an older year temporarily
- confirm which catalogue version staff should search against
Adding custom systems
If you need an internal coding system:
- Open Diagnosis systems.
- Click Code system.
- Enter the system key and display name.
- Optionally add country and description.
This is useful when the team works with internal shorthand but still needs clean mappings to external billing or reporting standards.
Managing codes inside a system
Open a system to see its codes.
From there you can:
- browse the code list
- add a new code with its system, version, code, and title
- open a specific code to manage mappings and information
Mapping codes between systems
Open a code detail page to manage Mapping.
Mappings let you connect one code to matching codes in another system, for example linking an internal code to an ICD-10-GM code.
Use mappings when:
- clinicians prefer internal shorthand
- billing or exports require a standardized code
- multiple catalogues need to stay aligned
Adding code guidance
Each code detail page also has an Information section.
Use it to attach richer reference content to the code, such as internal guidance or coding notes. This keeps reusable guidance on the catalogue entry instead of copying it into patient notes every time.
Day-to-day use
Most operators will not manage code systems every day. They will usually search and apply diagnosis codes while working in notes, Live Mode, or patient workflows.
This settings area keeps those day-to-day workflows consistent. Updating a system here changes what staff can search and map going forward, but it does not rewrite diagnoses that were already recorded on patients.