Force Update

In some cases, it is essential to ensure users update their applications directly through the app store instead of relying on over-the-air (OTA) updates via CodePush. This is particularly important when native-level changes are introduced that cannot be handled by CodePush.

When to Use Force Update

CodePush is limited to delivering updates to JavaScript files, images, and other assets. It does not support updates involving changes at the native layer—for example:

• Updates that include native dependencies or plugins.

• Changes made to native iOS or Android modules.

• Modifications to platform-specific configuration files.

In such scenarios, a store update is mandatory, and CodePush updates will not be delivered to affected users. To guide users to the app store for these updates, the Force Update mechanism can be applied.

To ensure users receive updates to your app through the store, you may want to guide them in that direction. CodePush has certain limitations. Specifically, when there are changes at the native layer or when a plugin working with the native layer is added, users must update their apps from the store. Updates of this kind sent through CodePush will not be received by users.

Eligible Builds for Force Update

Not all builds can be force-updated. The following rules apply:

• ✅ Eligible: Builds that were previously marked as Live and have since been replaced by newer Live builds.

• ❌ Not Eligible: Builds that have never been marked as Live, even if they were successful.

• ❌ Not Allowed: You cannot apply Force Update to the current Live build.

How to Apply a Force Update

To apply a Force Update to an older build:

1. Navigate to: Projects → Project Detail → Build Detail

2. Locate a previously Approved (but now inactive) build.

3. Click the Force Update link available in the build's detail view.

4. Confirm the action in the prompt that appears.

Once confirmed:

• A new CodePush process will be triggered.

• If the operation is successful, the update will be marked and delivered as a Force Update.

• Users still running the targeted old build will receive a mandatory update prompt directing them to the store.

This operation is irreversible. Ensure you apply Force Update only when it is absolutely required.

Users affected by the Force Update will encounter a mandatory update screen, preventing them from continuing to use the app until they update via the store.

Example screen: