5.1.0 release notes

Released 2026-02-26

Highlights

Previous month’s targets

Similar to CHT 4.10’s feature of allowing supervisors to see their CHW’s prior month’s aggregate targets, CHT 5.1 now enables CHWs to see their own prior month’s targets as well. The community had identified only being able to see the current month’s targets as a roadblock:

…indicators are reset to zero at the end of each month, making it difficult for CHWs to view and present data from the previous month using this tab.

Now CHWs can use the filter option to view their own targets for the current and prior months:

Choose current or prior month

Month view of last month's targets

This feature is multi-facility aware as well, enabling CHWs to choose between multiple facilities if enabled. See videos of this feature in use or head over to the GitHub ticket to read more.

Show overdue task count

Tasks continue to be an important way that CHWs interact with the CHT to know who is most in need of care. A compliment to CHT 4.21’s Task prioritization feature is 5.1’s ability to show a bubble with with the count of tasks that are due today or overdue. This gives CHWs a simple to read signal about outstanding items:

A red arrow points to a bubble on tasks icon. The bubble shows a count of '35', indicating overdue tasks

Attachments on contacts

While attachments have been possible on app forms for some time, this feature is now available on contact forms too. This enables deployments that need to attach, for example, a photo of a person or household to a contact. The documentation has more information or check out the video showing how it works.

A contact form with a 'Photo' field enabling an attachment

Android notifications

Some time ago, a member of the CHT community reached out to talk about the importance of native Android notifications that can exist outside the CHT:

CHT … needs to have some notifications for users as a way to remind … users on app activities such as pending tasks and incoming messages. Currently the user needs to open the app’s tasks/messages tab to get and update on these items. A notification feature can help in the usability by managing interactions with the app.

The requirement of launching the CHT to see what was important was holding back users. This is now solved in 5.1.0 with the introduction of the Android Notification feature which compliments the release of CHT Android 1.7 which adds support for the CHT feature. To find out more, check out the documentation or see a video from a round up call where the feature was demonstrated.

An Android notification informing the user that a pregnancy visit follow up task is due

Task filtering GUI

As a CHT deployment grows in number of patients it cares for, inherently the CHW delivering this care must juggle more tasks. When there’s too many tasks, critical house visits may be missed. The community let us know the CHT could be improved to better handle this:

Currently [our] program has more than 10 [workflows, but] when Community Health Nurses (CHNs) provide services in the community, they face challenges in navigating the CHIS app. With numerous tasks listed, it becomes difficult to scroll through and identify specific follow-up tasks for each use case.
To improve efficiency, I suggest implementing a filter option (similar to the reporting feature) that allows CHNs to select a specific form/use case and view only the relevant tasks they need to complete.

The ability to filter the task view to show different types of tasks and split between which are overdue and which are not, is now available:

A Filter interface allowing to show overdue vs not overdue and delivery vs pregnancy home visit types

Known issues

Check the repository for the latest known issues.

Upgrade notes

Breaking changes

None.

UI/UX changes

#10140: Add ability to display previous month’s targets
#3943: Show a count of overdue tasks in the nav bar
#6784: Alert Safari users CHT doesn’t support their browser
#9255: Enable android notifications for task reminders/alerts
#10577: Implement task filtering

And more…

Features

#10140: Add ability to display previous month’s targets
#10509: Support uploading attachments in contact forms
#10556: Add Portuguese translations for the CHT
#10577: Implement task filtering
#10607: Update google-libphonenumber to support new Nepali number scheme (+977971xxxxxxx)
#10610: Show design document comparison on the admin upgrade page
#3943: Show a count of overdue tasks in the nav bar
#6784: Alert Safari users CHT doesn’t support their browser
#9255: Enable android notifications for task reminders/alerts

Improvements

#10398: Store pre-purged doc counts per user
#10428: Send message state to clear if they are not good to mark for pending
#10446: Dont send empty messages
#10450: Add missing actions on cht-conf action
#10459: Configurable SMS Recipient Fallbacks & Disable “Sender” Default
#10473: Disable default send to sender in sms workflows
#10494: Prevent logging in with token in Safari Browser
#10644: Add telemetry to measure task filtering
#8336: Support trigger column in Forms

Security fixes

#10305: Protect against DoS attack

Performance improvements

None.

Bug fixes

#10354: Target aggregates not loading correctly for online users
#10386: Purge database created for admin role
#10444: Reading purged docs cache fails sometimes when the number of purged docs for a user is very large
#10452: User telemetry DB reused when logging in as a different user
#10525: Aggregate targets do not work when language is set to Nepali
#10598: Admin privacy policies do not load

Technical improvements

#10132: Update how API handles form updates on change
#10133: Update API startup form updates to not load all attachments with _all_docs
#10434: cht-core README Dev setup link is broken
#10440: Rearrange release notes so Highlights is first
#10475: Flaky unit test: change task state to clear when message generation fails and clear_failing_schedules is true
#10483: Flaky integration test: cht-datasource Person
#10486: Remove scripts/deploy
#10489: Failed test artifacts can no longer be uploaded when feedback docs are pesent
#10499: The new docs_by_replication_key nouveau index is not monitored
#10536: Add constant for ‘settings’ document ID
#10537: Add constant for ‘resources’ document ID
#10547: Add constant for ‘health_center’ document type
#10549: Add constants for ‘form’ and ’token_login’ document types
#10561: Clean up CouchDb config values
#10565: Flaky integration test: should work after restarting CouchDb @docker (2218ms)
#10628: Dependabot PRs fail compile test due to dependabot internals
#10633: API has some invalid or overly noisy log reporting
#10639: K3D e2e tests are failing
#10646: Add benchmarks for view indexing duration
#9621: Add a @medic/constants shared library
#9756: Assess whether saving allure-history as a means for build historical data is useful
#9916: Report details
#9922: Reports list - mobile & desktop view
#9997: ci-integration e2e test fails due to a race condition where not all containers are up

Contributors

Thanks to all who committed changes for this release!

Last updated on February 26, 2026

Did this documentation help you ?

5.0.2