Release Notes 3.7 (Goal: June 2026)
Have a feature to request or suggest?
Post: Share on Talk or in the #o3-releases Slack channel and mention your release goal (e.g. date or version number).
Discuss: For further verbal discussion you can also converse with the community on the weekly O3 Squad Calls or the daily - see the Community Calendar for call dates and times: om.rs/cal
Timing: Please communicate as early as possible to make sure your feature/work has enough time to be considered for the release!
Release Managers: Delete this blurb when release is nearing readiness.
🔦 Key Points
📆 Cut Date: 1 June 2026
📆 Release Date: 8 June 2026
Release Manager: @nethmi @Wikum Weerakutti
Key Features:
Beautiful + Configurable Login Page - MVP COMPLETE
Billing Enhancements - ongoing
Several features have been requested that would especially benefit the PATH DRC project.
The current billing-related work is largely focused on bug fixes and making the billing modules more stable.
31-Mar-2026: Backend PRs, Refund, Discount management (support needed on BE PR review - @Wikum Weerakutti to take this up)
28-Apr-2026
https://github.com/openmrs/openmrs-module-billing/pull/160 ✅
https://github.com/openmrs/openmrs-module-billing/pull/167 - @nethmi - UI pending
https://openmrs.atlassian.net/browse/O3-5410 - @nethmi - UI pending ✅
https://github.com/openmrs/openmrs-module-billing/pull/170 - @Wikum Weerakutti ✅
https://github.com/openmrs/openmrs-module-billing/pull/172 ✅ - @nethmi UI pending
Payment - cash and other payment modes - needs refactoring
Procedure History - mvp complete
METS kicked this work off during the September hackathon in Uganda but it stalled and needs to be completed (@Jayasanka Weerasinghe has taken this up).
Procedure History requirements document
Missing concepts have also been added to facilitate this task completion.
31-Mar-2026: BE merged, FE work ongoing (styling, edit, delete)
14-Mar-2026: Assess the current progress with @Jayasanka Weerasinghe
https://github.com/openmrs/openmrs-content-referenceapplication-demo/pull/71✅
https://github.com/openmrs/openmrs-esm-patient-chart/pull/3338 ✅
28-Apr-2026
Pending: Get the procedures concept set and related metadata in the demo content package.
7-May-2026
Concept blocker (O3-5652): Vero is kindly taking care of getting the OCL concept set/class defined. ✅
Procedure types on demo content package (O3-5658): Wikum offered to help on this.
Small UI fixes (O3-5077): I created a set of sub-tasks under this ticket and walked Dilan through them. He'll pick them up.
Merge to chart: Currently sitting on the `feat/procedure-history` branch. Dilan will open the PR and address review comments. @Nethmi Rodrigo @Dennis Kigen it would mean a lot if you could help get it (and above fixes) reviewed and merged to main.
12-May-2026
Dilan is working to get this online - Config work, Icon, e2e tests
https://github.com/openmrs/openmrs-esm-patient-chart/pull/3313
@Jayasanka Weerasinghe to fast-track this work, 19-May-2026
Order Favoriting - mvp complete
Requirements: Favorites: Favoriting Drugs, Diagnoses, and more
First iteration: PR
Second iteration: will be under the GSoC project
31-Mar-2026: Scope change communicated via Slack/Ticket (https://openmrs.slack.com/archives/CKS32D55G/p1774876009846929)
Keep this feature simple, at least for the MVP
Pin/unpin by clicking the pin icon - no save/cancel modal
Secondary pin inside the form is acceptable
Pin icon visible on all drugs - for discoverability
Remove "Clear All" for the MVP
No edit flow - the pin icon alone is sufficient for MVP
14-Mar-2026 @Veronica Muthee to do a talk post ✅
@Dennis Kigen pushed a fix for unescaping HTML encoded characters in drug order display names in notification snackbars ✅
Sticky Note Feature - mvp complete
This work was started during the September hackathon, but got stalled and needs to be completed.
Requirements: Sticky Note in O3
PR - https://github.com/openmrs/openmrs-esm-patient-chart/pull/2955 ✅
31-Mar-2026: Keep the first pass of this feature compatible with the O2 version. That means we should really only be using a single obs-per-patient as a sticky note. Because of how obs work, the whole history of the node is still there.
14-Mar-2026 @Dennis Kigen will take this up - MVP complete✅
Tasks and Task Lists - mvp complete
@Brandon Istenes (through Madiro) has already started this work.
Requirements: Tasks and Task List
31-Mar-2026: Need to check with Madiro (field experience - then we can plan how to bring this to the RefApp)
14-Mar-2026 @Ian Bacher will take this up - MVP complete ✅
Orders App and Results Viewer Improvements ongoing
Main PRs that need to go in
https://github.com/openmrs/openmrs-esm-laboratory-app/pull/661✅
https://github.com/openmrs/openmrs-esm-patient-chart/pull/2990✅
https://github.com/openmrs/openmrs-esm-laboratory-app/pull/634 - Needs feedback from a lab-tech ❌
@Dennis Kigen will try to get feedback from AMPATH lab-tech, 12-May-2026
Medications Improvements complete
PR - Autocalculate drug quantity ✅
https://github.com/openmrs/openmrs-esm-dispensing-app/pull/743 ✅
@Dennis Kigen to finalize the PR (14-Mar-2026)
https://github.com/openmrs/openmrs-esm-patient-chart/pull/2943#issuecomment-4162139152 ✅
Need to be tested locally first, all feedback resolved @Ian Bacher @Dennis Kigen
https://github.com/openmrs/openmrs-esm-patient-chart/pull/3198 ✅
@Dennis Kigen to finalize the PR (14-Mar-2026)
https://github.com/openmrs/openmrs-esm-patient-chart/pull/2973 ✅
https://github.com/openmrs/openmrs-esm-patient-chart/pull/3337 ✅
@Ian Bacher to finalize the PR (14-Mar-2026) - @Dennis Kigen to also take this up, 12-May-2026
Order sets - Start with something simple ongoing
Security Improvements (NSF project) ongoing
31-Mar-2026: No specific App functions for this.
Chart Search AI ⚠️ ongoing
31-Mar-2026: Prototype in place - fine-tuning of the modal is what is currently happening. Need to try with real patient data, also to bring it out to expose it out to the larger community.
Daniel’s Plan: Create a standalone to allow other folks to interact with this?
@Daniel Kayiwa creating a download link for folks to play around with the prototype (14-Mar-2026)
28-Apr-2026: Daniel is fixing the Docker Compose errors
12-May-2026: Daniel to include the module in dev3 as part of the 3.7 release (ESM + 1 backend module) - switch to querystore in the next version
Release for this feature DEFERRED to allow ample QA
Reference Ranges - complete
https://github.com/openmrs/openmrs-content-referenceapplication-demo/pull/63✅
https://github.com/openmrs/openmrs-esm-patient-chart/pull/3221#issuecomment-4249397560 ✅
https://github.com/openmrs/openmrs-esm-patient-chart/pull/3238 ✅
https://github.com/openmrs/openmrs-esm-patient-chart/pull/2378#issuecomment-4370337612 ✅
Printing encounters based on O3-forms - complete
Platform-related
@Wikum Weerakutti Please fill in the changes that have happened here
Others
Tech debt: ongoing
Migration to React 19: 12-May-2026 - deferred for the next release
Webpack → Rspack: Mostly done (31-Mar-2026) @Dennis Kigen @Ian Bacher will take this up, 12-May-2026 ✅
Build time performance improvements
https://github.com/openmrs/openmrs-esm-patient-chart/pull/3104 ✅
Jest → Vitest Migration: Some work on the billing module, doing this @Dennis Kigen @Ian Bacher will take this up, 12-May-2026 ✅
Unit test improvements
Moving shared logic from Common lib to the framework: Done (31-Mar-2026)✅
Migrating per-repo Github Actions workflows to centralized reusable workflows in https://github.com/openmrs/openmrs-contrib-gha-workflows:
Migrating Angular form engine to Angular v20:
e2e tests coverage improvements ongoing
Review of scenarios and adding coverage for new functionalities in the system (possibly need to add some edge cases … gradually)
31-Mar-2026: Dennis - looking into this → for general e2e coverage
⚠️ Breaking Changes:
_______
Where to find it: Demo at o3.openmrs.org (admin/Admin123) or download here: openmrs.org/download/
👷 Contributors
Special thanks to the following community PR reviewers:
DIGI: @Ian Bacher
OpenMRS: @Dennis Kigen, @Jayasanka Weerasinghe, @nethmi, …
PIH:
Palladium:
METS:
MSF Madiro:
Template note: Reach out to @beryl; she will be the primary builder of this list.
Thank you so much to the following contributors - you make releases like this possible! Alphabetically by Organization affiliation:
CSaude:
Health IT (UoN):
ICRC:
Intellisoft:
Madiro:
Mekom:
METS:
OpenMRS Support:
Palladium-Kenya:
PIH:
UCSF:
UW ITECH DIGI:
Independent Contributors:
Thank you, our wonderful translation contributors!
[Language] updated by [contributor-name]
Contributor Metrics
# PRs included: ___
# of Orgs involved: ___
% from OpenMRS Inc. Global Support: ___%
🔦 Highlights for Implementers
Change: Brief description. |
|
Change: Brief description. |
|
Change: Brief description. |
|
📸 Example Visual Changes
🔍 Detailed Changelog
Code:
Distro RefApp
Reference Application 3.5.0 (<-- needs hyperlink like this)
Frontend Modules
Cohort Builder v4.0.3 (patch) (<-- example only)
Patient Chart v10.0.0 ⚠️ (major - breaking change) (<-- example only)
Backend Modules
Core 2.7.4 (<-- example only)
Steps to figure this out: (see also 2nd video in this Talk thread: https://talk.openmrs.org/t/backend-contributions-to-emr-releases-why-and-how/46090 )
1. Find What Backend Modules Changed: Compare previous release’s distro/pom.xml file to this one, e.g.: https://github.com/openmrs/openmrs-distro-referenceapplication/compare/3.3.1...3.4.0-rc.2
2. Use release notes for those to figure out who contributed, e.g. https://github.com/openmrs/openmrs-module-webservices.rest/releases