Mobile Worker Groups

How to put your mobile workers into groups, allowing easier mobile worker management.

When to use Groups?

Here are some common use cases for groups:

Using Groups

There are two methods for creating and managing groups.

  • Manually creating and managing the groups is easy for small projects.

  • The bulk upload feature is easier for large projects or projects with lots of groups.

Managing Groups Manually

Navigate to CommCare HQ -> Users -> Application Users: Groups (see image below).

Create Groups

To create a group, type in a name, this will be the name of your group and then click on "+ Add Group" button.

You will then see your group configuration page.

You can delete the group by finding the red button at the top right corner of the page.

Adding and Removing Users

From the group configuration page, you can click on the Group Membership dropdown menu to add mobile workers to your group or the ( x ) button to remove mobile workers from your group.

Updating Group Settings

There are several settings that you can configure for each group by clicking on the "Edit Settings" button in the upper left corner:

  • Group Name: Here you can change the name of the group.

  • Case Sharing: Determines whether the members of the group will share cases; the default setting is OFF (see https://dimagi.atlassian.net/wiki/x/ITLKfw for more information).

  • Reporting: Determines whether the group name will appear in the filter for reports; the default setting is ON.

Please note that changes may not be reflected in CommCare immediately, but will happen once the mobile app syncs with the server.

Adding/Removing Users with Bulk Upload

If you have to create a lot of groups or work with a lot of users, it will be easier to use the Bulk Upload feature. For more information on this feature see .

When you download your users Excel file, note that the second tab has a list of all your groups. The key information about each group is the same as the settings above:

  • id - the unique CommCare id for the group

  • name - the name of the group

  • case-sharing? - whether or not case sharing is active (yes/no)

  • reporting? - whether or not reporting groups are on (yes/no)

The first tab, where all of the users are listed, can have a column called: group 1

In this column you will list the name of the group to which that user should belong.

When you assign a user to a group you just put the name of the group in the "group 1" column; however that group MUST be listed on the second tab.

If you want to assign users to a new group you need to at least add the group name to the second tab. When you upload the users excel file CommCare will automatically generate the id.

In order to see your new groups in the manual interface you must refresh the page.