Popular Help Content

No popular content.

Versions Compared


  • This line was added.
  • This line was removed.
  • Formatting was changed.


By default, app updates in CommCare will retrieve the latest starred build version of your app on HQ. However, there are 2 alternatives to this behavior that are available:

  1. "Latest buildversion" (available starting in CommCare 2.30) --  This setting will tell CommCare to retrieve the most recent build of an app, even if it is un-starred.
  2. "Latest saved state" (available starting in CommCare 2.34) – This setting will tell CommCare to retrieve the current working state of your app, even if no build has been created for it yet. 

The update target setting is configured on a per-app, per-device basis, with the goal of allowing app builders and other project admins to use one of these alternative settings, while leaving normal CommCare users on the default setting, so that they only receive starred buildsapp versions.

How can I configure my update target?

In CommCare 2.30 to CommCare 2.33: Navigate to the main settings menu and select "Enable Updating to Un-Starred Builds". From there, selecting "Enabled" will set your update target to "Latest build", while selecting "Disabled" will set your update target to the default of the latest starred build version.

In CommCare 2.34 and above: There are 2 locations in CommCare where you can set your app's update target: either from the main Settings screen of the app (the same place where the "Enable Updating to Un-Starred Builds" setting used to be), or from the options menu of the Update screen. Screenshots of both locations can be seen below.


From the settings screen:

Image RemovedImage Added

From the update screen:

Image RemovedImage Added