--- description: Fix common Capacitor and Cordova Live Update issues β€” no update delivered, updates not applied, crashes after an update, and signature failures. title: Live Update Troubleshooting - Capawesome image: https://capawesome.io/docs/assets/images/social/cloud/live-updates/troubleshooting.png --- [ Skip to content](#troubleshooting) [ πŸ” Introducing the **Capacitor Vault** plugin β€” store secrets behind biometrics or a device passcode.](/blog/announcing-the-capacitor-vault-plugin/) * [ SDKs ](/docs/sdks/) * [ Formbricks ](/docs/sdks/capacitor/formbricks/) * [ Geocoder ](/docs/sdks/capacitor/geocoder/) * [ Google Sign-In ](/docs/sdks/capacitor/google-sign-in/) * [ Grafana Faro ](/docs/sdks/capacitor/grafana-faro/) * [ libSQL ](/docs/sdks/capacitor/libsql/) * [ Live Update ](/docs/sdks/capacitor/live-update/) * [ Managed Configurations ](/docs/sdks/capacitor/managed-configurations/) * [ Media Session ](/docs/sdks/capacitor/media-session/) * [ ML Kit ](/docs/sdks/capacitor/mlkit/) * [ Navigation Bar ](/docs/sdks/capacitor/navigation-bar/) * [ NFC ](/docs/sdks/capacitor/nfc/) * [ OAuth ](/docs/sdks/capacitor/oauth/) * [ Pedometer ](/docs/sdks/capacitor/pedometer/) * [ Photo Editor ](/docs/sdks/capacitor/photo-editor/) * [ PostHog ](/docs/sdks/capacitor/posthog/) * [ Printer ](/docs/sdks/capacitor/printer/) * [ Purchases ](/docs/sdks/capacitor/purchases/) * [ RealtimeKit ](/docs/sdks/capacitor/realtimekit/) * [ Screen Orientation ](/docs/sdks/capacitor/screen-orientation/) * [ Screenshot ](/docs/sdks/capacitor/screenshot/) * [ Secure Preferences ](/docs/sdks/capacitor/secure-preferences/) * [ Speech Recognition ](/docs/sdks/capacitor/speech-recognition/) * [ Speech Synthesis ](/docs/sdks/capacitor/speech-synthesis/) * [ Share Target ](/docs/sdks/capacitor/share-target/) * [ Square Mobile Payments ](/docs/sdks/capacitor/square-mobile-payments/) * [ SQLite ](/docs/sdks/capacitor/sqlite/) * [ Superwall ](/docs/sdks/capacitor/superwall/) * [ Torch ](/docs/sdks/capacitor/torch/) * [ Vault ](/docs/sdks/capacitor/vault/) * [ Wifi ](/docs/sdks/capacitor/wifi/) * [ Zip ](/docs/sdks/capacitor/zip/) * [ Cordova ](/docs/sdks/cordova/) * [ Cloud ](/docs/cloud/) * [ Integrations ](/docs/cloud/live-updates/integrations/) * Concepts * Reference * Troubleshooting [ Troubleshooting ](/docs/cloud/live-updates/troubleshooting/) * [ FAQ ](/docs/cloud/live-updates/faq/) * [ Native Builds ](/docs/cloud/native-builds/) * [ Set Up Environments ](/docs/cloud/native-builds/environments/) * [ Overwrite Native Configurations ](/docs/cloud/native-builds/native-configurations/) * [ Auto-Increment Build Numbers ](/docs/cloud/native-builds/auto-incrementing-build-numbers/) * [ Configure the Web Build Script ](/docs/cloud/native-builds/web-build-script/) * [ Build from a Monorepo ](/docs/cloud/native-builds/monorepo/) * [ Use pnpm or Yarn ](/docs/cloud/native-builds/package-managers/) * [ Install Private npm Packages ](/docs/cloud/native-builds/npm-private-registry/) * [ Override the Java Version ](/docs/cloud/native-builds/override-java-version/) * [ Custom iOS Provisioning Profiles ](/docs/cloud/native-builds/custom-ios-provisioning-profiles/) * [ Build without Git ](/docs/cloud/native-builds/build-without-git/) * [ Access Git Behind a Firewall ](/docs/cloud/native-builds/firewall-access/) * [ Integrations ](/docs/cloud/native-builds/integrations/) * Reference * [ Troubleshooting ](/docs/cloud/native-builds/troubleshooting/) * [ FAQ ](/docs/cloud/native-builds/faq/) * [ App Store Publishing ](/docs/cloud/app-store-publishing/) * [ Submit a Build ](/docs/cloud/app-store-publishing/submit-a-build/) * [ Submit Automatically After a Build ](/docs/cloud/app-store-publishing/submit-automatically/) * [ Troubleshooting ](/docs/cloud/app-store-publishing/troubleshooting/) * [ FAQ ](/docs/cloud/app-store-publishing/faq/) * [ Automations ](/docs/cloud/automations/) * [ Reference ](/docs/cloud/automations/reference/) * [ Troubleshooting ](/docs/cloud/automations/troubleshooting/) * [ FAQ ](/docs/cloud/automations/faq/) * [ Assist ](/docs/cloud/assist/) * [ CLI ](/docs/cloud/cli/) * APIs and SDKs * [ Webhooks ](/docs/cloud/webhooks/) * [ Integrations ](/docs/cloud/integrations/) * Account * [ Organization ](/docs/cloud/organizations/) * [ Two-Factor Enforcement ](/docs/cloud/organizations/two-factor-authentication/) * [ Audit Logs ](/docs/cloud/organizations/audit-logs/) * [ Billing ](/docs/cloud/organizations/billing/) * [ License Keys ](/docs/cloud/license-keys/) * [ AI ](/docs/ai/) * [ Insiders ](/docs/insiders/) * [ Billing & Plans ](/docs/insiders/billing-and-plans/) * [ FAQ ](/docs/insiders/faq/) * [ License ](https://capawesome.io/legal/eula/) * [ Support ](/docs/support/) * [ Contributing ](/docs/contributing/) * Contributing code * [ Code of Conduct ](/docs/contributing/code-of-conduct/) * [ Questions ](https://docs.github.com/en/discussions/collaborating-with-your-community-using-discussions/participating-in-a-discussion#creating-a-discussion) * [ Blog ](/blog/) * Categories # Troubleshooting[ΒΆ](#troubleshooting "Permanent link") Most Live Update issues can be diagnosed from the [Logs](/docs/cloud/live-updates/logs/) view in the Console, which shows each device-to-cloud request, the channel it requested, and the bundle it was served. Start there, then match your symptom below. ## Check the native logs[ΒΆ](#check-the-native-logs "Permanent link") The SDK also prints diagnostic messages on the device itself. When something doesn't behave as expected, run the app on a device or simulator and watch the native logs for any errors or warnings from the Live Update SDK β€” they often point straight at the cause: * **Android** β€” view Logcat in Android Studio, or run `adb logcat` from the terminal. * **iOS** β€” open the Xcode console while the app is running. ## No update is delivered to the device[ΒΆ](#no-update-is-delivered-to-the-device "Permanent link") Check these causes, roughly in order of likelihood: 1. **Channel mismatch** β€” the device is subscribed to a different channel than you published to. Check the [Logs](/docs/cloud/live-updates/logs/) to see which channel the device requested. This is the most common cause when using versioned channels. 2. **Native-version incompatibility** β€” the bundle is restricted to a native version range that doesn't include the device. See [Binary-Compatible Changes](/docs/cloud/live-updates/binary-compatible-changes/). 3. **Rollout** β€” the bundle is at less than 100% and this device isn't in the rollout group. See [Roll out gradually](/docs/cloud/live-updates/rollouts/). 4. **Strategy not triggering** β€” with `autoUpdateStrategy: none` and no manual `sync()`, no check happens. With `background`, checks are throttled to once every 15 minutes β€” force-close and restart to trigger one immediately. 5. **Blocked or rolled-back bundle** β€” `autoBlockRolledBackBundles` blocks a bundle that previously failed to start. See [Roll back a release](/docs/cloud/live-updates/rollbacks/). 6. **Signature rejected** β€” if the bundle is signed but the app's configured public key doesn't match, the bundle is rejected. See [Sign your bundles](/docs/cloud/live-updates/code-signing/). 7. **Quota or lifecycle** β€” your MAU or data transfer [limit](/docs/cloud/live-updates/limits/) was reached, or the bundle expired or was deleted. 8. **Network** β€” the device can't reach Capawesome Cloud, or a custom `serverDomain` is misconfigured. ## An update is downloaded but not applied[ΒΆ](#an-update-is-downloaded-but-not-applied "Permanent link") The bundle is staged but the WebView still shows the old version. This usually means the app hasn't reloaded yet: * With `background`, the new bundle is applied on the **next** app launch β€” force-close and restart. * If you use a manual strategy, make sure you call `reload()` after the bundle is staged. See [Choose an Update Strategy](/docs/cloud/live-updates/update-strategies/). ## The app crashes or rolls back after an update[ΒΆ](#the-app-crashes-or-rolls-back-after-an-update "Permanent link") * A bundle that depends on a native feature the installed binary doesn't have will crash on launch. Make updates [version-compatible](/docs/cloud/live-updates/binary-compatible-changes/). * If you use automatic rollback, the app reverts to the previous bundle when `ready()` isn't called within `readyTimeout`. Make sure you call `ready()` early at app start. See [Roll back a release](/docs/cloud/live-updates/rollbacks/). ## Signature verification fails[ΒΆ](#signature-verification-fails "Permanent link") The bundle's signature doesn't match the public key in your app config. Confirm you're signing with the matching private key and that the public key in your config is correct. See [Sign your bundles](/docs/cloud/live-updates/code-signing/). ## Still stuck?[ΒΆ](#still-stuck "Permanent link") Reach out via [Support](/docs/support/) with the relevant entries from the [Logs](/docs/cloud/live-updates/logs/) view. June 8, 2026 Back to top