---
description: View and manage devices that receive Live Updates from Capawesome Cloud — channel assignment, forcing a channel for QA, and deleting devices.
title: Manage Devices Receiving Live Updates - Capawesome
image: https://capawesome.io/docs/assets/images/social/cloud/live-updates/devices.png
---

[ Skip to content](#manage-devices) 

[ 🔐 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 ](/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

# Manage Devices[¶](#manage-devices "Permanent link")

A **device** is a unique installation of your app that has connected to Capawesome Cloud to check for Live Updates. Each device is identified by a unique device ID and receives updates from a single channel. Managing devices lets you monitor and control how updates are distributed.

## Channel assignment[¶](#channel-assignment "Permanent link")

A device's channel is chosen by your app. Pass the `channel` directly to `sync()` (or `fetchLatestBundle()`) at the call site — for example, deriving it from the native version code so updates stay [version-compatible](/docs/cloud/live-updates/binary-compatible-changes/):

CapacitorCordova

`` [](#%5F%5Fcodelineno-0-1)import { LiveUpdate } from "@capawesome/capacitor-live-update";
[](#%5F%5Fcodelineno-0-2)
[](#%5F%5Fcodelineno-0-3)const { versionCode } = await LiveUpdate.getVersionCode();
[](#%5F%5Fcodelineno-0-4)await LiveUpdate.sync({ channel: `production-${versionCode}` });
 ``

`` [](#%5F%5Fcodelineno-1-1)const { versionCode } = await cordova.plugins.LiveUpdate.getVersionCode();
[](#%5F%5Fcodelineno-1-2)await cordova.plugins.LiveUpdate.sync({ channel: `production-${versionCode}` });
 ``

For the different ways to select a channel — including the recommended native default channel — see [Subscribe to a channel](/docs/cloud/live-updates/channel-subscription/).

## Manage Devices[¶](#manage-devices%5F1 "Permanent link")

You can manage devices associated with your app using the Capawesome CLI or the Capawesome Cloud Console.

### Create a device[¶](#create-a-device "Permanent link")

Devices are created automatically when a user checks for a live update for the first time by calling the `fetchLatestBundle(...)` or `sync()` method from the [Live Update SDK](/docs/cloud/live-updates/setup/).

### Force a channel[¶](#force-a-channel "Permanent link")

By default, devices receive live updates from the channel set by the Live Update SDK. You can override this by forcing a specific channel on a device. When a channel is forced, the SDK-selected channel is ignored and the device receives updates exclusively from the forced channel instead. This can be useful for debugging, testing, or manually managing the channel for a specific device. Read our [blog post](/blog/capawesome-cloud-forced-channel-assignments/) for more details and use cases.

CLIConsole

To force a channel on a device using the [Capawesome CLI](/docs/cloud/cli/), use the [apps:devices:forcechannel](/docs/cloud/cli/commands/#appsdevicesforcechannel) command:

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

You will be prompted to select the app and provide the device ID and channel name.

To remove the forced channel and return to normal SDK behavior, use the [apps:devices:unforcechannel](/docs/cloud/cli/commands/#appsdevicesunforcechannel) command:

`[](#%5F%5Fcodelineno-3-1)npx @capawesome/cli apps:devices:unforcechannel
`

To force a channel on a device using the [Capawesome Cloud Console](https://console.cloud.capawesome.io/), navigate to the app you want to force the channel for, and click on the [Devices](https://console.cloud.capawesome.io/apps/%5F/devices) menu item under the "Live Updates" section in the sidebar. Next, click on "Edit" in the "Actions" menu of the device you want to force a channel for. In the dialog, select the channel you want to force and confirm the changes.

![Force Channel](/docs/assets/images/screenshots/cloud-app-devices-forced-channel.png)

### Delete a device[¶](#delete-a-device "Permanent link")

A device can be deleted at any time.

CLIConsole

To delete a device using the [Capawesome CLI](/docs/cloud/cli/), use the [apps:devices:delete](/docs/cloud/cli/commands/#appsdevicesdelete) command:

`[](#%5F%5Fcodelineno-4-1)npx @capawesome/cli apps:devices:delete
`

You will be prompted to select the app you want to delete the device for and to provide the ID of the device. The CLI will then delete the device from the Capawesome Cloud.

To delete a device using the [Capawesome Cloud Console](https://console.cloud.capawesome.io/), navigate to the app you want to delete the device for, and click on the [Devices](https://console.cloud.capawesome.io/apps/%5F/devices) menu item under the "Live Updates" section in the sidebar. Next, select the device you want to delete. In the menu, click on the "Delete" button to delete the device.

![Delete Device](/docs/assets/images/screenshots/cloud-app-devices-delete.png)

Please note that deleting a device will **not lower your Monthly Active Users (MAU) count** as this is based on unique devices that have connected within the current billing period.

June 8, 2026 

 Back to top