--- description: Publish a new Live Update bundle to your Capacitor or Cordova app with Capawesome Cloud — upload from your machine or build in the cloud. title: Publish a Live Update - Capawesome image: https://capawesome.io/docs/assets/images/social/cloud/live-updates/publish.png --- [Skip to content ](#publish-a-live-update) [🔐 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/) * [ Build in the cloud ](#build-in-the-cloud) * [ Choose a channel ](#choose-a-channel) * [ Next steps ](#next-steps) * [ Roll Out Gradually ](/docs/cloud/live-updates/rollouts/) * [ Roll Back a Release ](/docs/cloud/live-updates/rollbacks/) * [ Choose an Update Strategy ](/docs/cloud/live-updates/update-strategies/) * [ Subscribe to a Channel ](/docs/cloud/live-updates/channel-subscription/) * [ Download and Apply Updates ](/docs/cloud/live-updates/manual-updates/) * [ Manage Channels ](/docs/cloud/live-updates/channels/) * [ Sign Your Bundles ](/docs/cloud/live-updates/code-signing/) * [ Reduce Update Size ](/docs/cloud/live-updates/bundle-size/) * [ Self-Host Bundles ](/docs/cloud/live-updates/self-hosting/) * [ Proxy API Requests ](/docs/cloud/live-updates/request-proxying/) * [ Manage Devices ](/docs/cloud/live-updates/devices/) * [ 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 * [ Build in the cloud ](#build-in-the-cloud) * [ Choose a channel ](#choose-a-channel) * [ Next steps ](#next-steps) # Publish a Live Update[¶](#publish-a-live-update "Permanent link") Publishing an update is the workflow you repeat every release: get your web assets into Capawesome Cloud as a new **bundle**, which is then delivered to devices according to your [update strategy](/docs/cloud/live-updates/update-strategies/). There are two ways to do it: * **[Upload from your machine](#upload-from-your-machine)** — build your web assets locally and upload the result. Works on any Live Updates plan and doesn't use build minutes. * **[Build in the cloud](#build-in-the-cloud)** — let Capawesome Cloud build your web assets for you, for a consistent, reproducible release. ## Upload from your machine[¶](#upload-from-your-machine "Permanent link") Build your web assets, then upload them with the [Capawesome CLI](/docs/cloud/cli/) — the same command for Capacitor and Cordova: `[](#%5F%5Fcodelineno-0-1)npm run build [](#%5F%5Fcodelineno-0-2)npx @capawesome/cli apps:liveupdates:upload ` You'll be prompted for the path to your web assets directory (e.g. `www` or `dist`) and the target app. After the upload completes, the bundle is available to your users. Open the [Deployments](https://console.cloud.capawesome.io/apps/%5F/deployments) page in the Console to review it. To run it non-interactively (for example in a script), pass the values as flags: `[](#%5F%5Fcodelineno-1-1)npx @capawesome/cli apps:liveupdates:upload \ [](#%5F%5Fcodelineno-1-2) --app-id 00000000-0000-0000-0000-000000000000 \ [](#%5F%5Fcodelineno-1-3) --path dist \ [](#%5F%5Fcodelineno-1-4) --channel production ` ### Options[¶](#options "Permanent link") | Option | Description | | --------------------- | ------------------------------------------------------------------------------------------------------- | | \--channel | The channel to publish to. Defaults to the channel's default. | | \--private-key | Sign the bundle with your private key. See [Sign your bundles](/docs/cloud/live-updates/code-signing/). | | \--rollout-percentage | Release to a subset of devices first. See [Roll out gradually](/docs/cloud/live-updates/rollouts/). | | \--artifact-type | zip (default) or manifest. See [Reduce update size](/docs/cloud/live-updates/bundle-size/). | | \--git-ref | Associate the bundle with a Git commit. | See the [CLI command reference](/docs/cloud/cli/commands/#appsliveupdatesupload) for the full list. ## Build in the cloud[¶](#build-in-the-cloud "Permanent link") Instead of building locally, you can let Capawesome Cloud build your web assets and deploy the result — all in a single command: `[](#%5F%5Fcodelineno-2-1)npx @capawesome/cli apps:builds:create --platform web --git-ref main --channel production ` Capawesome Cloud checks out the given Git reference, installs your dependencies, builds your web assets, and deploys the resulting bundle to the channel. Why build in the cloud: * **Consistent, reproducible builds.** Every release uses the same Node.js version, the same dependencies, and the same configuration — no more "works on my machine" surprises between team members or CI runners. * **Your environment and secrets.** Cloud builds can use the [environment variables and secrets](/docs/cloud/native-builds/environments/) you've configured in Capawesome Cloud (pass `--environment`). A local upload can't access those. * **Builds from Git, not your working tree.** Build from a branch, tag, or commit so what ships always matches what's in your repository. * **No local tooling required.** Useful in CI, or simply to keep your machine out of the release path. Building in the cloud uses **build minutes**, so it's available on plans that include build runners. If your plan doesn't, the [upload](#upload-from-your-machine) approach works on any Live Updates plan. For the full set of build options and ready-made pipeline examples, see [Native Builds](/docs/cloud/native-builds/builds/) and [Integrations](/docs/cloud/live-updates/integrations/). ## Choose a channel[¶](#choose-a-channel "Permanent link") Every device receives updates from a [channel](/docs/cloud/live-updates/channels/). If you don't specify one, the bundle is published to the default channel. Pass `--channel` (with either approach above) to target a specific channel — for example a `staging` channel for testers, or a versioned `production-` channel to keep updates [compatible with the installed app version](/docs/cloud/live-updates/binary-compatible-changes/): `[](#%5F%5Fcodelineno-3-1)npx @capawesome/cli apps:liveupdates:upload --channel staging ` ## Next steps[¶](#next-steps "Permanent link") * [Roll out gradually](/docs/cloud/live-updates/rollouts/) — release to a percentage of users first. * [Roll back a release](/docs/cloud/live-updates/rollbacks/) — recover from a bad update. * [Automate publishing in CI/CD](/docs/cloud/live-updates/integrations/). June 15, 2026 Back to top