What’s new in Connect.

Release Notes: CommCare Mobile v2.62

Planned Release: 31 Mar 2026
Audience: Connect users
External documentation:

CommCare Mobile v2.62 introduces a major redesign of the Connect Landing Page to improve the design, functionality, and end-to-end flow of opportunities. Key enhancements focus on user experience and information delivery, including the addition of Hausa language support, updated push notifications for instant assessment results (pass/fail), and a streamlined payment notification system. The release also features enhanced geospatial navigation for frontline workers, providing more accurate mapping and clearer visual cues within their target areas, alongside several key bug fixes

1. Landing Page Redesign

The Connect Landing Page has been redesigned to improve the design, functionality, and process flow of opportunities within the Connect app, end-to-end.

Key updates:

• Updated opportunity card: Refreshed card design for clearer at-a-glance information

• Progress indicator: A new visual indicator tracks your progress through an opportunity

• Opportunity states: Improved handling and display of different opportunity states

• Updated Learn/Delivery overview page: A refreshed overview experience for Learn and Delivery workflows

Enhancements & Improvements

1. Hausa Language Support

The app is now available in Hausa, with translated UI text throughout the platform.

2. Assessment Result Push Notification

After completing a Learn assessment, you will now receive a push notification as soon as your results are scored, indicating whether you have passed or failed. Tapping the notification takes you directly to the Job Status page so you can review your assessment outcome immediately.

3. Updated Payment Push Notification Behavior

The push notification received when you are paid for an opportunity has been updated. Key changes:

• The notification now displays the message: "You have received a payment for [opportunity name] Opportunity, see how much!"

• The Yes/No response options have been removed

• Tapping the notification takes you directly to the Payments tab on the Delivery Status page

4. Enhanced Geospatial Navigation in CommCare

The geospatial feature in CommCare now provides improved navigation for frontline workers within their target areas. This update includes:

• More accurate mapping

• Clearer visual cues for boundaries and key locations

• Better understanding of areas relevant to your assigned work

Bug Fixes

1. Fingerprint Configuration Error Message Update

When configuring a fingerprint during registration, you will no longer see an erroneous error message after returning from the setup process. The page now correctly reflects your updated status and prompts you with the appropriate next action. A unit test has been added to ensure this behavior remains consistent going forward.

2. Payment Tab Display Update

The payment tab now retains its correct height when switching between tabs. All payment entries remain fully visible, and the screen no longer resizes to match the height of the progress tab.

3. Automatic Navigation After App Installation

After installing a new app from the App Manager, you are now directed to the Login page with the newly installed app loaded by default. Previously, users were returned to the App Manager rather than being taken directly to the app's login experience.

Release Notes: CommCare Mobile v2.61

Planned Release: 01 Dec 2025
Audience: Connect users
External documentation:

The 2.61 release of the Connect mobile app introduces several new features, enhancements, and bug fixes designed to improve usability, task tracking, and overall user experience. This release includes a central Notification History, Work History with digital Credentials, improved PersonalID signup flow, and updated error messaging across the app.

1. Push Notifications and Notification History

We’ve improved push notifications to make them more reliable, even if the user doesn’t have internet at the time.

Key updates:

• Notification History page: Users can now refer back to all Connect platform notifications at any time.

• Types of notifications included:

  • New Opportunities

  • Reminders to resume learning

  • Reminders to resume delivery tasks / perform delivery visits

  • New payments

• Centralized access: Previously, notification history could only be seen in the device’s notifications tray. Now, users can access it directly via:

  • Sidebar menu

  • Notification bell icon in the title bar

• Quick navigation: Tapping any item in Notification History takes the user directly to the relevant task or page.

• No changes to existing notifications: Timing, content, and configuration of Push Notifications or PersonalID messages for Connect Opportunities remain the same.

2. Work History & Digital Credentials

Workers with a configured PersonalID can now earn digital badges (Credentials) for completed delivery work.

Details for workers:

• View earned badges in a new Work History page.

• Receive push notifications when a new Credential is awarded.

Details for PMs:

• PMs can configure preset thresholds for awarding Credentials in the Edit Opportunity menu.

• New and existing Opportunities default to not issuing Credentials.

• Enabling Credentials on existing Opportunities backfills previously earned badges.

Future enhancements:

• Credentials for Learn modules

• Pending or "not yet earned" badge views

• Credentials for CommCareHQ activities

• Custom delivery thresholds

Enhancements & Improvements

1. Sidebar Menu Behavior After PersonalID Signup

• Sidebar automatically opens during the first session after PersonalID registration.

• On subsequent sessions, it remains collapsed unless manually expanded.

2. Location Status Indicator on PersonalID Signup

During PersonalID signup, the app now provides clear messages about device location:

• "Trying to get location…" while retrieving location

• "Location Captured" once location is successfully acquired

• If the location cannot be obtained, an error message explains the requirement and the Continue button remains disabled until resolved

3. Sign In / Register Button

• Updated from a link to a button in the sidebar for better visibility and alignment with the app’s styling.

4. Completed Learn Task Banner

• Learn tasks that have already been completed now display a green success banner instead of the previous red banner.

5. Improved Error Messaging

• Error messages across the app have been updated for clearer language and guidance.

• Many messages now include actionable next steps or updated links to relevant actions.

Bug Fixes

1. Unconfigured PersonalID/Connect Access

• If a user opens PersonalID/Connect from a push notification without a configured account, a clear error message now appears prompting setup.

• Users are redirected to the Setup/Login page instead of experiencing a crash.

2. Messaging Option Visibility

• The Messaging menu item now appears immediately in the sidebar after signing in with PersonalID, if messaging channels exist.

• Previously, it only appeared after navigating away and returning to the start screen.

Release Notes: CommCare Mobile v2.60

Planned Release: October 20, 2025
Audience: Connect users
External documentation:

We’ve made several updates to improve your experience using the mobile app.

This release includes design enhancements, workflow improvements, and important bug fixes to make things run more smoothly.

Highlights at a glance

• Messages are now accessed through the side navigation menu, with a new unread indicator

• Android 15 users will see a refreshed edge-to-edge UI on key screens

• The app is now locked to portrait mode to prevent download errors

• Duplicate account creation using the same phone number is no longer allowed

• Sign-up process improved with better OTP delivery handling

• Clearer error messages for failed opportunity claims

Enhancements and Improvements

• Easier Access to Messages

  • Messages have moved from the top bar to the side navigation menu.

  • An unread message indicator (dot) now appears when you have new messages.

  • This update streamlines navigation and helps you stay on top of communications.

• Updated Design for Android 15

  • The Connect and PersonalID screens now support Android 15’s edge-to-edge display.

  • Content now extends behind the system bars, providing a cleaner and more modern experience aligned with the latest Android standards.

• Portrait Mode Only

  • To prevent download issues caused by screen rotation, the app is now temporarily locked to portrait orientation.

  • This change ensures stable downloads while we work on a permanent fix.

• Remove Ability to Create New Accounts with Existing Phone Numbers

  • Users can no longer create multiple accounts using the same phone number.

  • This prevents data and progress loss and ensures each account remains properly linked.

• Improved OTP Sign-Up Reliability

  • The sign-up process via PersonalID is now more robust.

  • If sending the OTP fails during sign-up, the app will now automatically try a different service (Twilio). The message format from Twilio may look slightly different, but functionality works the same.

• Bug Fixes: Clearer Error Messages for Failed Opportunity Claims

  • If a claim fails (e.g. because an opportunity is full or the budget is exhausted), the app now displays a clear message explaining the reason.

  • This helps users understand the issue and what to do next.

Overview

This release introduces significant updates, including the merge of all Connect Code into the mainline CommCare code and a new side menu in PersonalID to improve navigation. These changes will impact onboarding and training.

Beta Program No Longer Required

• All Connect features are now merged into the mainline CommCare codebase.

• Users no longer need to subscribe to the CommCare Beta program to access Connect functionality.

• Updating the CommCare app as usual will move users from the Beta channel to the 2.59 release.

• Frontline Workers should not be directed to sign up for the Beta during onboarding going forward.

NOTE: The 2.59 mainline release will roll out in phases over the first week (Aug 25, 2025 to 30 Aug 2025) During this time, beta users can continue to use the beta version. After one week, once the mainline release is fully deployed (100% users), the Beta Program will no longer be available. Connect users will no longer need to sign up for the beta, the latest version will be available by default.

New Side Menu in PersonalID

Access & Availability

• A side menu is added to PersonalID to streamline navigation, accessible via a hamburger icon (≡) in the upper left corner of the app.

• The side menu can appear on the Setup, Login, and App Home pages:

  • Always available on the Setup page.

  • Available on Login and App Home pages only if a PersonalID is configured on the device.

  • Once enabled on the Login page, it remains available even if the user "forgets" their PersonalID.

Side Menu States

• Logged out State

  • Option to "Sign in / Register"

    • After you complete the PersonalID signup flow, you will be returned to the setup page.

  • About CommCare in the footer and app version

• Logged in state:

  • Opportunities will be displayed on the side menu if pre-invited or if you have existing opportunities

  • "CommCare Apps" menu item is included on the side menu

    • If you have no CommCare apps installed the "CommCare Apps" menu item will not be shown

    • The CommCare app you last used (the "seated app") will be highlighted on the Login or Home screen.

  • If user has PersonalID messaging channels, "Messaging" menu item is shown

Opportunities Access

• Users pre-registered to an Opportunity can select "Opportunities" from the side menu to access their Opportunity list.

• Non-pre-registered users can:

  • Open the 3-dot menu on the Setup page

  • Select "Check for Opportunities"

  • If available, the Connect menu appears to navigate to Opportunities

  • Otherwise if no Opportunities are available, users see a "Try again later" message.

Additional Side Menu Details

• The app version is displayed at the bottom of the side menu.

• After signing in with PersonalID, users’ photo and name appear in the side menu

• Analytical events added when the menu is opened and when a menu item is selected

🚀 Release Notes: Introducing PersonalID: Biometric Login for CommCare

Release Date: June 2025

Audience: Connect users

External documentation: View documentation ↗

🔐 What is PersonalID?

PersonalID is a new secure login method for CommCare mobile users that leverages the phone’s built-in biometrics (like fingerprints) to provide fast and secure access to all CommCare apps on a device, no password typing required.

With PersonalID, users can log into multiple project spaces using a single, universal ID tied to their personal phone number.

🌟 Key Benefits

• Streamlined Access: Log in faster using fingerprint, no need to remember or enter passwords.

• Cross-App Authentication: One PersonalID grants access across all CommCare applications on the device.

• Device-Based Security: Biometric data is never stored or collected by CommCare, authentication happens using native phone tools.

• Offline Access: Once set up, PersonalID can be used without internet connectivity.

👤 Who Should Use It?

This feature is currently in limited release for select Connect projects.

Dimagi does not yet recommend general use of PersonalID unless:

• You're part of a Connect deployment, or

• A Dimagi point of contact has advised you to use it.

A general availability (GA) rollout is expected later in 2025.

🛠️ How It Works

Setup Steps:

1. Open CommCare Android and select "Sign up for PersonalID" from the 3-dot menu.

2. Enter and verify your personal phone number via a One-Time Passcode (OTP).

3. Configure your fingerprint on the device.

4. Provide your full name, create a 6-digit Backup Code, and take a profile photo.

5. Once complete, you'll be able to log in using your phone’s biometric prompt.

Login Experience:

• Unlock your PersonalID using your fingerprint

• Access CommCare apps linked to your PersonalID, no separate passwords required.

⚠️ Important Notes

• A backup code is required to recover your PersonalID on a new device or reinstall.

• Users must have their own phone number and device for PersonalID.

• After 3 failed attempts to enter a backup code, the PersonalID will be locked and must be recreated.

• Biometric authentication must be set up on the phone before PersonalID can be enabled.

📌 Known Limitations

• Currently limited to select Connect projects.

• Not supported for shared devices or users without personal phone numbers.

• Cannot be used on devices that do not support biometrics.

🔜 Coming Soon

In late 2025, PersonalID will become available to all CommCare users. At that time, we’ll encourage all users with personal phones to switch to PersonalID for a faster, more secure experience.

CCC Web UI released on 30 May 2025

🚀 Overview

We are excited to announce the launch of the revamped CCC Web UI, designed to improve user experience and interface clarity for both internal Dimagi Program team members and external users, including Network Managers and locally led organizations.

This release is a UI/UX refresh only, all existing functionality remains intact. However, users will benefit from a richer set of operational metrics, enabling deeper insights and improved tracking of CCC activities.

✨ What’s New

• Modernized User Interface: A cleaner, more intuitive layout for improved navigation and ease of use.

• Enhanced User Experience: Streamlined workflows that make day-to-day interactions more efficient.

• Expanded Metrics Dashboard: Access to new operational metrics for better monitoring and decision-making.

🧭 Rollout Plan

• The upgrade will be rolled out universally, to all users currently on CCC will be migrated to the new UI at the same time.

• Internal teams onboarded with the staging environment and did an initial review of the new UI.

• We are actively monitoring feedback and questions over the next 2 weeks. Please submit any issues or questions on this form for an expedited response.

📚 Support & Onboarding

• Watch onboarding video ↗

• Self-Onboarding: The new UI is designed to be intuitive. Users are encouraged to explore and self-onboard.

• Task Guide for Network Managers with Video Tutorials: A task guide is available here, including video tutorials and a glossary of terms.

• As there are a lot of new metrics and numbers in the new UI, users may initially have questions on how to reconcile them across different parts of the UI. There is guidance available here before you reach out to the tech team through the support process

Beta APK 468051 released on 7 April 2025

1. Fixed scrolling issues on the mobile "Job Status" page. The scrolling issue disabled the user from scrolling all the way down to view the progress corresponding to different payment units

2. Fixed the information displayed on the "Job Status" page corresponding to different payment units. The "Remaining" section within each payment unit now shows the exact no. of approved visits a user needs to do within the number of days left for the opportunity to end. Also, the progress bar shows progress as each approved visit is executed by the mobile worker.

CCC Web release on 4 April 2025

1. With this change, a Connect web app user won't be allowed to invite a mobile worker to the opportunity as long as the opportunity setup is not complete. This further ensures a mobile worker doesn't interact with an incomplete opportunity and experiences app crashes

2. The PM can now add additional deliver units to a an app and make it visible within a payment unit by using the sync button below:

Better error handling to prevent 500 errors

Beta APK 468048 released on 2 April 2025

Fixed a P1 bug unintentionally introduced as part of beta release 468047. This issue was faced by multiple users wherein the users were unable to continue with delivery. The opportunity showed incorrectly as ended, even though the end date was in future

Beta APK 468047 released on 1 April 2025

Added Swahili translation