--- description: Learn how to gradually roll out Live Updates for your Capacitor app using the Capawesome Cloud and the Capawesome CLI. title: How to gradually roll out Live Updates for Capacitor apps - Capawesome image: https://capawesome.io/docs/assets/images/social/blog/how-to-gradually-roll-out-capacitor-live-updates.png --- [Skip to content ](#how-to-gradually-roll-out-capacitor-live-updates) [🖥️ Introducing the **Capacitor Electron Platform** — build desktop apps for macOS, Windows, and Linux. Free & open source. ](/blog/announcing-the-capacitor-electron-platform/) * [ 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/) * [ Gyroscope ](/docs/sdks/capacitor/gyroscope/) * [ Haptics ](/docs/sdks/capacitor/haptics/) * [ Home Indicator ](/docs/sdks/capacitor/home-indicator/) * [ In-App Browser ](/docs/sdks/capacitor/in-app-browser/) * [ Install Referrer ](/docs/sdks/capacitor/install-referrer/) * [ Intercom ](/docs/sdks/capacitor/intercom/) * [ Intune ](/docs/sdks/capacitor/intune/) * [ Keep Awake ](/docs/sdks/capacitor/keep-awake/) * [ libSQL ](/docs/sdks/capacitor/libsql/) * [ Light Sensor ](/docs/sdks/capacitor/light-sensor/) * [ Live Update ](/docs/sdks/capacitor/live-update/) * [ Localization ](/docs/sdks/capacitor/localization/) * [ Mail Composer ](/docs/sdks/capacitor/mail-composer/) * [ Managed Configurations ](/docs/sdks/capacitor/managed-configurations/) * [ Maps Launcher ](/docs/sdks/capacitor/maps-launcher/) * [ Media Session ](/docs/sdks/capacitor/media-session/) * [ ML Kit ](/docs/sdks/capacitor/mlkit/) * [ Navigation Bar ](/docs/sdks/capacitor/navigation-bar/) * [ Network ](/docs/sdks/capacitor/network/) * [ NFC ](/docs/sdks/capacitor/nfc/) * [ Node.js ](/docs/sdks/capacitor/nodejs/) * [ OAuth ](/docs/sdks/capacitor/oauth/) * [ Passkeys ](/docs/sdks/capacitor/passkeys/) * [ Password Autofill ](/docs/sdks/capacitor/password-autofill/) * [ PDF Generator ](/docs/sdks/capacitor/pdf-generator/) * [ PDF Viewer ](/docs/sdks/capacitor/pdf-viewer/) * [ Pedometer ](/docs/sdks/capacitor/pedometer/) * [ Permissions ](/docs/sdks/capacitor/permissions/) * [ Phone Dialer ](/docs/sdks/capacitor/phone-dialer/) * [ Photo Editor ](/docs/sdks/capacitor/photo-editor/) * [ Photo Manipulator ](/docs/sdks/capacitor/photo-manipulator/) * [ PixLive ](/docs/sdks/capacitor/pixlive/) * [ PostHog ](/docs/sdks/capacitor/posthog/) * [ Printer ](/docs/sdks/capacitor/printer/) * [ Privacy Screen ](/docs/sdks/capacitor/privacy-screen/) * [ Proximity Sensor ](/docs/sdks/capacitor/proximity-sensor/) * [ Purchases ](/docs/sdks/capacitor/purchases/) * [ RealtimeKit ](/docs/sdks/capacitor/realtimekit/) * [ Root Detection ](/docs/sdks/capacitor/root-detection/) * [ Screen Brightness ](/docs/sdks/capacitor/screen-brightness/) * [ Screen Orientation ](/docs/sdks/capacitor/screen-orientation/) * [ Screen Reader ](/docs/sdks/capacitor/screen-reader/) * [ Screenshot ](/docs/sdks/capacitor/screenshot/) * [ Secure Preferences ](/docs/sdks/capacitor/secure-preferences/) * [ Settings Launcher ](/docs/sdks/capacitor/settings-launcher/) * [ Shake ](/docs/sdks/capacitor/shake/) * [ Silent Mode ](/docs/sdks/capacitor/silent-mode/) * [ SIM ](/docs/sdks/capacitor/sim/) * [ SMS Composer ](/docs/sdks/capacitor/sms-composer/) * [ 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/) * [ System WebView ](/docs/sdks/capacitor/system-webview/) * [ Tauri ](/docs/sdks/capacitor/tauri/) * [ Text Interaction ](/docs/sdks/capacitor/text-interaction/) * [ Text Zoom ](/docs/sdks/capacitor/text-zoom/) * [ Thermal State ](/docs/sdks/capacitor/thermal-state/) * [ Toast ](/docs/sdks/capacitor/toast/) * [ Torch ](/docs/sdks/capacitor/torch/) * [ Vault ](/docs/sdks/capacitor/vault/) * [ Volume ](/docs/sdks/capacitor/volume/) * [ Wallet ](/docs/sdks/capacitor/wallet/) * [ Wifi ](/docs/sdks/capacitor/wifi/) * [ YouTube Player ](/docs/sdks/capacitor/youtube-player/) * [ Zip ](/docs/sdks/capacitor/zip/) * [ Cordova ](/docs/sdks/cordova/) * [ Cloud ](/docs/cloud/) * [ Integrations ](/docs/cloud/live-updates/integrations/) * Concepts * Reference * [ 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, Yarn, or bun ](/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 * [ Related Posts ](#related-posts) * [ Conclusion ](#conclusion) * Related links # How to gradually roll out Capacitor Live Updates[¶](#how-to-gradually-roll-out-capacitor-live-updates "Permanent link") [Live Updates](/docs/cloud/live-updates/) are a powerful feature that allows you to deliver updates to your Capacitor app in real-time without having to resubmit your app to the app stores. In order to ensure a smooth rollout of updates, it is recommended to gradually roll out updates to your users. This way you can minimize potential issues and collect feedback from a smaller group of users before rolling out the update to all users. Deprecated This guide is deprecated. Please refer to the [Rollouts](/docs/cloud/live-updates/rollouts/) guide for the latest information. ## Introduction[¶](#introduction "Permanent link") In this guide, we will show you how to gradually roll out updates to your users using the [Capawesome Cloud](/docs/cloud/). First, we will roll out a new bundle to a small percentage of users and then gradually increase the percentage of users that receive the update. For this, we will use the [Capawesome CLI](/docs/cloud/cli/). ## Create a bundle[¶](#create-a-bundle "Permanent link") To create a new bundle, you need to use the [apps:liveupdates:upload](/docs/cloud/cli/commands/#appsliveupdatesupload) command of the Capawesome CLI. Once the bundle is created, it is immediately available to all users. To roll out the bundle to only 10% of users, for example, you can use the `--rollout-percentage` option as follows: `[](#%5F%5Fcodelineno-0-1)npx @capawesome/cli apps:liveupdates:upload --rollout-percentage 10 ` Note that the `--rollout-percentage` option accepts a value between 0 and 100, where 0 means that the bundle is not rolled out to any users and 100 means that the bundle is rolled out to all users. ## Update a bundle[¶](#update-a-bundle "Permanent link") To update an existing bundle, you can use the [apps:liveupdates:rollout](/docs/cloud/cli/commands/#appsliveupdatesrollout) command of the Capawesome CLI. In order to increase the rollout percentage, you can use the `--percentage` option as follows: `[](#%5F%5Fcodelineno-1-1)npx @capawesome/cli apps:liveupdates:rollout --percentage 30 ` In this example, the bundle is now rolled out to 30% of users. You can always see the current rollout percentage of a bundle in the [Capawesome Cloud Console](https://console.cloud.capawesome.io/). ## FAQ[¶](#faq "Permanent link") ### What does a 10% rollout percentage actually mean for existing users?[¶](#what-does-a-10-rollout-percentage-actually-mean-for-existing-users "Permanent link") It determines what share of devices on that channel are eligible to receive the new bundle when they check in — it's not a random one-time draw across your whole user base at upload time. Devices outside the current percentage simply keep running their existing bundle until you raise the percentage or complete the rollout to 100%. ### Can I roll back a rollout that's already at 30% if something looks wrong?[¶](#can-i-roll-back-a-rollout-thats-already-at-30-if-something-looks-wrong "Permanent link") Yes — you can stop or reduce the rollout at any point by adjusting the percentage, and Capawesome Cloud's automatic rollback (built-in bundle fallback on a failed start) still applies independently to any device that already downloaded the problematic bundle. The two mechanisms work together: reducing the rollout percentage stops new devices from picking up the bad bundle, while automatic rollback protects devices that already have it. ### Is this guide still the current way to configure rollouts?[¶](#is-this-guide-still-the-current-way-to-configure-rollouts "Permanent link") No — this guide is marked deprecated in favor of the [Rollouts](/docs/cloud/live-updates/rollouts/) documentation, which reflects the current CLI commands and options. The core concept (start small, watch for issues, increase gradually) is unchanged, but check the current docs for exact flag names before scripting a rollout. ## Related Posts[¶](#related-posts "Permanent link") * [Announcing the Live Update Plugin for Capacitor](/blog/announcing-the-capacitor-live-update-plugin/) * [Capacitor App Updates: The Complete Guide](/blog/capacitor-app-update-guide/) * [Channel Pausing for Capawesome Cloud Live Updates](/blog/capawesome-cloud-channel-pausing/) ## Conclusion[¶](#conclusion "Permanent link") By gradually rolling out updates to your users, you can minimize potential issues and gather valuable feedback from your users. For the bigger picture, see [Capacitor Live Updates: A Complete Guide to OTA Updates](/blog/capacitor-live-updates-guide/), and to understand the mechanics behind it, read [How Live Updates for Capacitor Work](/blog/how-live-updates-for-capacitor-work/). If you have any questions, just [create a discussion](https://github.com/capawesome-team/capacitor-plugins/discussions/new/choose) in the GitHub repository. Make sure you follow [Capawesome](https://twitter.com/capawesomeio) on X so you don't miss any future updates. July 17, 2026 Back to top ```json { "@context": "https://schema.org", "@type": "BlogPosting", "headline": "How to gradually roll out Live Updates for Capacitor apps", "description": "Learn how to gradually roll out Live Updates for your Capacitor app using the Capawesome Cloud and the Capawesome CLI.", "image": "https://capawesome.io/assets/banners/cloud-build-and-deploy-capacitor-apps.png", "datePublished": "2024-05-29T00:00:00+00:00", "dateModified": "2026-07-17T00:00:00+00:00", "author": [ { "@type": "Person", "name": "Robin Genz", "url": "https://github.com/robingenz" } ], "publisher": { "@type": "Organization", "name": "Capawesome", "url": "https://capawesome.io", "logo": { "@type": "ImageObject", "url": "https://capawesome.io/assets/images/logo.svg" } }, "articleSection": "Capacitor", "keywords": ["Capacitor", "Cloud", "Guides", "SDKs"], "isPartOf": { "@type": "Blog", "@id": "https://capawesome.io/blog/#blog" }, "mainEntityOfPage": "https://capawesome.io/blog/how-to-gradually-roll-out-capacitor-live-updates/", "url": "https://capawesome.io/blog/how-to-gradually-roll-out-capacitor-live-updates/" } { "@context": "https://schema.org", "@type": "BreadcrumbList", "itemListElement": [ { "@type": "ListItem", "position": 1, "name": "Home", "item": "https://capawesome.io/" }, { "@type": "ListItem", "position": 2, "name": "Blog", "item": "https://capawesome.io/blog/" }, { "@type": "ListItem", "position": 3, "name": "How to gradually roll out Live Updates for Capacitor apps", "item": "https://capawesome.io/blog/how-to-gradually-roll-out-capacitor-live-updates/" } ] } {"@context": "https://schema.org", "@type": "FAQPage", "mainEntity": [{"@type": "Question", "name": "What does a 10% rollout percentage actually mean for existing users?", "acceptedAnswer": {"@type": "Answer", "text": "It determines what share of devices on that channel are eligible to receive the new bundle when they check in — it's not a random one-time draw across your whole user base at upload time. Devices outside the current percentage simply keep running their existing bundle until you raise the percentage or complete the rollout to 100%."}}, {"@type": "Question", "name": "Can I roll back a rollout that's already at 30% if something looks wrong?", "acceptedAnswer": {"@type": "Answer", "text": "Yes — you can stop or reduce the rollout at any point by adjusting the percentage, and Capawesome Cloud's automatic rollback (built-in bundle fallback on a failed start) still applies independently to any device that already downloaded the problematic bundle. The two mechanisms work together: reducing the rollout percentage stops new devices from picking up the bad bundle, while automatic rollback protects devices that already have it."}}, {"@type": "Question", "name": "Is this guide still the current way to configure rollouts?", "acceptedAnswer": {"@type": "Answer", "text": "No — this guide is marked deprecated in favor of the Rollouts documentation, which reflects the current CLI commands and options. The core concept (start small, watch for issues, increase gradually) is unchanged, but check the current docs for exact flag names before scripting a rollout."}}], "url": "https://capawesome.io/blog/how-to-gradually-roll-out-capacitor-live-updates/"} ```