---
description: Learn how to manage rollbacks in Capawesome Cloud, including automatic and manual rollbacks. This is useful when a new deployment does not work as expected.
title: Rollbacks - Capawesome
image: https://capawesome.io/docs/assets/images/social/cloud/live-updates/advanced/rollbacks.png
---

[ Skip to content](#rollbacks) 

[ 🎉 Introducing **Capawesome Platform** — one platform for Live Updates, Native Builds, App Store Publishing, and Insider SDKs.](https://capawesome.io) 

* [  Formbricks ](/docs/plugins/formbricks/)
* [  Geocoder ](/docs/plugins/geocoder/)
* [  Google Sign-In ](/docs/plugins/google-sign-in/)
* [  libSQL ](/docs/plugins/libsql/)
* [  Live Update ](/docs/plugins/live-update/)
* [  Managed Configurations ](/docs/plugins/managed-configurations/)
* [  Media Session ](/docs/plugins/media-session/)
* [  ML Kit ](/docs/plugins/mlkit/)
* [  NFC ](/docs/plugins/nfc/)
* [  OAuth ](/docs/plugins/oauth/)
* [  Pedometer ](/docs/plugins/pedometer/)
* [  Photo Editor ](/docs/plugins/photo-editor/)
* [  PostHog ](/docs/plugins/posthog/)
* [  Printer ](/docs/plugins/printer/)
* [  Purchases ](/docs/plugins/purchases/)
* [  RealtimeKit ](/docs/plugins/realtimekit/)
* [  Screen Orientation ](/docs/plugins/screen-orientation/)
* [  Screenshot ](/docs/plugins/screenshot/)
* [  Secure Preferences ](/docs/plugins/secure-preferences/)
* [  Speech Recognition ](/docs/plugins/speech-recognition/)
* [  Speech Synthesis ](/docs/plugins/speech-synthesis/)
* [  Share Target ](/docs/plugins/share-target/)
* [  Square Mobile Payments ](/docs/plugins/square-mobile-payments/)
* [  SQLite ](/docs/plugins/sqlite/)
* [  Superwall ](/docs/plugins/superwall/)
* [  Torch ](/docs/plugins/torch/)
* [  Wifi ](/docs/plugins/wifi/)
* [  Zip ](/docs/plugins/zip/)
* [  Cloud ](/docs/cloud/)
* [  Live Updates ](/docs/cloud/live-updates/)
* Advanced
* [  Rollouts ](/docs/cloud/live-updates/advanced/rollouts/)
* [  Self-Hosting ](/docs/cloud/live-updates/advanced/self-hosting/)
* Integrations
* [  Native Builds ](/docs/cloud/native-builds/)
* [  Configuration ](/docs/cloud/native-builds/configuration/)
* [  Environments ](/docs/cloud/native-builds/environments/)
* Guides
* [  Sample Projects ](/docs/cloud/native-builds/sample-projects/)
* [  Troubleshooting ](/docs/cloud/native-builds/troubleshooting/)
* [  Automations ](/docs/cloud/automations/)
* [  Assist ](/docs/cloud/assist/)
* Account
* Organizations
* [  Organization and User Management ](/docs/cloud/organizations/memberships/)
* [  Single Sign-On (SSO) ](/docs/cloud/organizations/sso/)
* [  Teams ](/docs/cloud/organizations/teams/)
* [  Two-Factor Authentication ](/docs/cloud/organizations/two-factor-authentication/)
* [  Integrations ](/docs/cloud/integrations/)
* [  License Keys ](/docs/cloud/license-keys/)
* [  Webhooks ](/docs/cloud/webhooks/)
* [  Pricing ](https://capawesome.io/pricing/)
* [  FAQ ](/docs/cloud/faq/)
* [  Support ](/docs/cloud/support/)
* [  Contributing ](/docs/contributing/)
* [  LLMs ](/docs/llms/)
* [  Insiders ](/docs/insiders/)
* [  License ](https://capawesome.io/legal/eula/)
* [  Support ](/docs/insiders/support/)
* [  FAQ ](/docs/insiders/faq/)
* [  Blog ](/blog/)
* Categories

# Rollbacks[¶](#rollbacks "Permanent link")

Rollbacks are a way to revert to a previous bundle of your app. This is useful when you have deployed a new bundle of your app and it is not working as expected. 

## Automatic Rollbacks[¶](#automatic-rollbacks "Permanent link")

The Live Update SDK can automatically roll back to the previous bundle if the new bundle fails to load or if your app does not signal that it is ready within a specified timeout period. To enable automatic rollbacks, you need to configure the `readyTimeout` option in your Capacitor configuration file.

capacitor.config.json

`[](#%5F%5Fcodelineno-0-1){
[](#%5F%5Fcodelineno-0-2)    "plugins": {
[](#%5F%5Fcodelineno-0-3)        "LiveUpdate": {
[](#%5F%5Fcodelineno-0-4)            "autoBlockRolledBackBundles": true,
[](#%5F%5Fcodelineno-0-5)            "readyTimeout": 10000
[](#%5F%5Fcodelineno-0-6)        }
[](#%5F%5Fcodelineno-0-7)    }
[](#%5F%5Fcodelineno-0-8)}
`

The `readyTimeout` option specifies the maximum time (in milliseconds) to wait for your app to signal that it is ready before rolling back to the built-in bundle. The `autoBlockRolledBackBundles` option automatically blocks bundles that caused a rollback and skips them in future operations, preventing your app from getting stuck in a rollback loop.

Your app must call the `ready()` method directly at app startup before the timeout expires, otherwise the SDK will roll back to the built-in bundle. Call this method as early as possible in your app's lifecycle—for example, in the `ngOnInit` or `created` hooks (Angular/Vue) or in the `useEffect` hook (React) of your root component:

`[](#%5F%5Fcodelineno-1-1)import { LiveUpdate } from "@capawesome/capacitor-live-update";
[](#%5F%5Fcodelineno-1-2)
[](#%5F%5Fcodelineno-1-3)const initializeApp = async () => {
[](#%5F%5Fcodelineno-1-4)  await LiveUpdate.ready();
[](#%5F%5Fcodelineno-1-5)  // Continue with app initialization...
[](#%5F%5Fcodelineno-1-6)};
`

Read more about this configuration options in the [Live Update](/docs/plugins/live-update/#configuration) plugin documentation.

## Manual Rollbacks[¶](#manual-rollbacks "Permanent link")

You can manually roll back to a previous bundle using either the Capawesome CLI or the Capawesome Cloud Console.

CLIConsole

To roll back to a previous bundle using the [Capawesome CLI](/docs/cloud/cli/), you can use the `apps:liveupdates:rollback` command:

`[](#%5F%5Fcodelineno-2-1)npx @capawesome/cli apps:liveupdates:rollback --help
`

You will be prompted to select the app and the channel you want to roll back. After selecting the app and channel, you will see a list of previous deployments. Select the deployment you want to roll back to, and confirm the rollback.

To roll back to a previous bundle using the [Capawesome Cloud Console](https://console.cloud.capawesome.io/), navigate to the app you want to roll back for, and click on the [Channels](https://console.cloud.capawesome.io/apps/%5F/channels) menu item under the "Live Updates" section in the sidebar. Next, navigate to the history page of the desired live update channel. You will see a list of previous deployments with a "Rollback" button next to each deployment. Click the "Rollback" button next to the deployment you want to roll back to, and confirm the rollback.

![Rollback Bundle](/docs/assets/images/screenshots/cloud-app-bundles-rollback.png)

A new deployment will be created that points to the selected previous bundle.

May 7, 2026 

 Back to top