4.21.0 release notes
Released "2025-06-25"
Known issues
Check the repository for the latest known issues.
Upgrade notes
Breaking changes
None.
UI/UX changes
- #9957: Implement task sorting by priority
Highlights
Sorting tasks by priority and then due date
When many tasks are due or overdue, it’s overwhelming or almost impossible for CHWs to effectively evaluate which tasks are most urgent. 4.21.0 introduces a new default way of sorting tasks in the frontend, based on the task priority score, with the tasks with the highest priority appearing at the top of the list. The priority score is a number calculated based on task configuration. If the project configuration does not implement the new priority scoring, the task sorting will remain unchanged, with tasks being sorted by their due date.
See the documentation for more details on configuration and functionality.
Accessing the logged-in user’s contact summary in app forms and app forms permissions
Workflows becoming more complex require additional context data to be correct and accurate. To bridge a gap in context data, the logged-in user’s contact summary is now available in app forms and app forms properties. This allows hiding/displaying forms depending on the current user’s context and allows data about the logged-in user to be used in form calculations.
See the form inputs documentation and the form properties documentation for more details on configuration and functionality.
Support opening contact edit form from task
Task actions with type: 'contact' can now be configured to redirect the user to the contact form to edit a contact, while this feature previously only allowed redirecting to a contact form to create a contact.
See the documentation for more details on configuration and functionality.
And more…
Features
- #9301: Expose user’s contact summary when filling out forms
- #9957: Implement task sorting by priority
- #9974: Support opening contact edit form from task
Bug fixes
- #10068: CHT SMS message sent via Africa’s Talking stuck in “pending” state
- #9825: Receiving new report for child contact does not refresh contact detail page
Technical improvements
- #10013: CI fails due to Docker Compose error followed by undici fetch errors
- #10027: Upgrade CouchDB to version 3.5.0
- #10033: Flaky integration test: auditing should add entry on PUT
- #10050: Flaky e2e test: should add a task when CHW completes a task successfully, and that task creates another task
- #9998: Flaky e2e test: Should add a task when CHW completes a task successfully, and that task creates another task
Contributors
Thanks to all who committed changes for this release!
Did this documentation help you ?