--- description: View and manage devices that receive Capacitor Live Updates from Capawesome Cloud. Track app installations and device connections for live update delivery. title: Devices Receiving Live Updates - Capawesome image: https://capawesome.io/docs/assets/images/social/cloud/live-updates/devices.png --- [ Skip to content](#devices) [ 🎉 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/) * [ Grafana Faro ](/docs/plugins/grafana-faro/) * [ 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/) * [ Navigation Bar ](/docs/plugins/navigation-bar/) * [ 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/) * [ Manage Devices ](#manage-devices) * [ Logs ](/docs/cloud/live-updates/logs/) * [ FAQ ](/docs/cloud/live-updates/faq/) * Guides * Advanced * 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 * [ Manage Devices ](#manage-devices) # Devices[¶](#devices "Permanent link") Devices represent unique installations of your app that have connected to the Capawesome Cloud to check for live updates. Each device is identified by a unique device ID and can be associated with a specific channel to control which updates it receives. Managing devices allows you to monitor and control the distribution of your live updates effectively. ## Channel Assignment[¶](#channel-assignment "Permanent link") Each device can be assigned to a specific [Channel](/docs/cloud/live-updates/channels/) to control which live updates it receives. There are two ways to set a channel for a device: ### Set a channel[¶](#set-a-channel "Permanent link") You can set the channel programmatically by calling the [setChannel(...)](/docs/plugins/live-update/#setchannel) method from the [Live Update](/docs/plugins/live-update/) plugin: `[](#%5F%5Fcodelineno-0-1)import { LiveUpdate } from '@capawesome/capacitor-live-update'; [](#%5F%5Fcodelineno-0-2) [](#%5F%5Fcodelineno-0-3)const setChannel = async () => { [](#%5F%5Fcodelineno-0-4) await LiveUpdate.setChannel({ channel: 'production' }); [](#%5F%5Fcodelineno-0-5)}; ` This is the recommended approach as it allows the app to select the appropriate channel automatically without manual intervention. For example, you could dynamically assign a channel based on the app's native version code to ensure each version only receives compatible updates (see [Versioned Channels](/docs/cloud/live-updates/guides/best-practices/#versioned-channels)): `` [](#%5F%5Fcodelineno-1-1)import { LiveUpdate } from '@capawesome/capacitor-live-update'; [](#%5F%5Fcodelineno-1-2) [](#%5F%5Fcodelineno-1-3)const sync = async () => { [](#%5F%5Fcodelineno-1-4) // Get the version code of the native app [](#%5F%5Fcodelineno-1-5) const { versionCode } = await LiveUpdate.getVersionCode(); [](#%5F%5Fcodelineno-1-6) // Automatically download and set the latest compatible bundle [](#%5F%5Fcodelineno-1-7) await LiveUpdate.sync({ channel: `production-${versionCode}` }); [](#%5F%5Fcodelineno-1-8)}; `` ### Force a channel[¶](#force-a-channel "Permanent link") Alternatively, you can force a specific channel for a device via the Capawesome Cloud Console. Navigate to the app's [Devices](https://console.cloud.capawesome.io/apps/%5F/devices) page, select the device, and assign a channel on the detail page. A channel set through the Cloud Console **takes precedence** over any channel set by the Live Update plugin. This can be useful for testing purposes, such as directing a specific device to a staging channel regardless of what the app itself requests. ## Manage Devices[¶](#manage-devices "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(...)](/docs/plugins/live-update/#fetchLatestBundle) or [sync()](/docs/plugins/live-update/#sync) method from the [Live Update](/docs/plugins/live-update/) plugin. ### Force a channel[¶](#force-a-channel%5F1 "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/#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/#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/#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. April 1, 2026 Back to top