Devices

Data retention

Device data is retained for 90 days from the last device activity. Devices that have not connected to Capgo during that period are automatically removed from the list.

Show the list of all devices

Open your app, then select the Devices tab.

1. Devices tab - Open the device inventory.
2. Filters - Filter devices by:
   • Override - Show devices with a custom channel or custom version.
   • Custom ID - Show devices with a custom identifier.

Configure a device

Select a device in the table to open its detail page.

A device detail page can show the latest request-derived country code.

1. Information - View the device ID, last update, platform, updater version, installed and native versions, OS version, emulator and production state, encryption-key prefix, and request country when available.
2. Deployments - View the deployment history for this device.
3. Logs - View logs associated with this device.
4. Channel override - Route this device to a specific private channel. When set, it takes precedence over normal channel selection.

Request country

Country is the latest valid two-letter ISO 3166-1 code received from a Cloudflare-handled request for that device. It is not GPS or a location value sent by your app. Requests without a valid country do not clear the last valid value, and the field is absent when Capgo has no valid country for the device.

How device information is updated

The updater and stats endpoints report device metadata when the app checks in. A device does not need to install an update to appear or refresh its details: an updater check that returns no_new_version_available can still record the reported metadata. Capgo skips redundant writes when that metadata has not changed, so Last update does not necessarily change after every check-in.

Device metadata and MAU are different signals. See Why my device number is different than my MAU? for the billing distinction.

Custom ID

The Custom ID helps you associate a device with an identifier you recognize for your users. Set it from the device with CapacitorUpdater.setCustomId({ customId: user }).

Keep going from Devices

If you are using Devices to plan dashboard and API operations, connect it with API Overview for the implementation detail in API Overview, Introduction for the implementation detail in Introduction, API Keys for the implementation detail in API Keys, Devices for the implementation detail in Devices, and Bundles for the implementation detail in Bundles.