# Viewing all devices

Source: https://cumulocity.com/docs/device-management-application/viewing-all-devices/
Sector: Device management & connectivity
Release: Latest

> **Related topics:**
> * The [managed objects API](https://cumulocity.com/api/core/#tag/Managed-objects) for REST API methods concerning managed objects (devices or groups of devices).



To view all devices connected to your account, click **All devices** in the **Devices** menu in the navigator.

A detailed device list will be displayed.

![Device list](https://cumulocity.com/docs/images/users-guide/DeviceManagement/devmgmt-devices-alldevices.png)


## Default columns

For each device, the device list shows the following information provided in columns:

<table>
<thead>
<colgroup>
   <col style="width: 20%;">
   <col style="width: 80%;">
   </colgroup><thead>
<tr>
<th style="text-align:left">Column</th>
<th style="text-align:left">Description</th>
</tr>
</thead>
<tbody>
<tr>
<td style="text-align:left">Status</td>
<td style="text-align:left">An icon representing the connection status. For details, see <a href="https://cumulocity.com/docs/device-management-application/monitoring-and-controlling-devices/#connection-monitoring" class="no-ajaxy">Connection monitoring</a>.</td>
</tr>
<tr>
<td style="text-align:left">Name</td>
<td style="text-align:left">Unique name of the device.</td>
</tr>
<tr>
<td style="text-align:left">Model</td>
<td style="text-align:left">Model type of the device. Not always displayed, depends on browser width.</td>
</tr>
<tr>
<td style="text-align:left">Serial Number</td>
<td style="text-align:left">Serial number of the device. Not always displayed, depends on browser width.</td>
</tr>
<tr>
<td style="text-align:left">Group</td>
<td style="text-align:left">Group the device is assigned to, if any.</td>
</tr>
<tr>
<td style="text-align:left">Registration Date</td>
<td style="text-align:left">Date when the device was registered to your account.</td>
</tr>
<tr>
<td style="text-align:left">System ID</td>
<td style="text-align:left">System ID of the device.</td>
</tr>
<tr>
<td style="text-align:left">IMEI</td>
<td style="text-align:left">IMEI of the device.</td>
</tr>
<tr>
<td style="text-align:left">Alarms</td>
<td style="text-align:left">The alarm status of the device, showing number and type of alarms currently unresolved for the device. Only includes alarms for the parent device. See <a href="https://cumulocity.com/docs/device-management-application/monitoring-and-controlling-devices/#working-with-alarms" class="no-ajaxy">Working with alarms</a> for further information on working with alarms.</td>
</tr>
</tbody>
</table>

For users with global roles the devices list displays the items in a paginated manner. You can select the number of items per page and directly jump to any page. Users with inventory roles see up to 50 items initially. If there are more than 50 devices available more devices are loaded as you scroll down the list.

## Configuring columns

The columns shown in the device list may be configured to your needs.

### To show/hide standard columns {#to-showhide-standard-columns}

1. In the table header, click **Configure columns**.
2. In the resulting dropdown, select/clear the checkboxes for all columns as required.

The device list will reflect your changes and only show the selected columns.

### To add custom columns {#to-add-custom-columns}

The device grid offers the option to add custom columns to display selected additional device properties. There are two alternative ways for adding custom columns.

#### With Digital Twin Manager {#with-digital-twin-manager}

If the **Digital Twin Manager** application is available on your tenant, you can use pre-configured asset properties to add them as custom columns. Read how to create asset properties in the [Asset models > Asset properties](https://cumulocity.com/docs/dtm/asset-types/#asset-properties) section.

1. In the **Configure columns** dropdown, click **Add custom column**. An **Asset properties** modal will open that lets you browse through all declared asset properties.<br>
   ![Configure columns](https://cumulocity.com/docs/images/users-guide/DeviceManagement/devmgmt-grid-custom-columns.png)<br>
2. Browse through the list to find the property you want to display. You can filter the list by **Title**, **Key** and **Tags**. An arrow
   in the first column indicates that the property is a complex property. Click on the arrow to expand the list of its nested properties.
3. Check the radio button and the new column will be added and displayed in the device list.

#### By defining a custom property path {#by-defining-a-custom-path-property}

If the **Digital Twin Manager** application is not available on your tenant, you can still create custom columns by manually providing the path to the property you want to display.

1. In the **Configure columns** dropdown, click **Add custom column**.<br>
   ![Configure columns](https://cumulocity.com/docs/images/users-guide/DeviceManagement/devmgmt-device-list-custom-column.png)<br>
2. In the **Header** field, enter a header for the new custom column.
3. In the **Fragment path** field, enter the property of the device to be shown. Nested properties will be accepted. However, for nested properties its only possible to select Cumulocity standard fragments like `c8y_Mobile.mcc`.
4. Switch the **Add another column after saving this one** toggle to active to create another custom column right after saving the current one without leaving the dialog.
5. Click **Save**.

The new column will be added and displayed in the device list.


> **Info:**
> While standard columns can only be shown/hidden as required, custom columns may be deleted permanently.

## To filter devices

The device list offers a filtering functionality to filter devices in the list for specific criteria.

Filtering is available on every column. Click the filter icon <i class="dlt-c8y-icon-filter icon-20"></i> next to the name of the column you want to set a filter for.

Specify your filter options in the dropdown list.

Most columns represent text fields. You can filter these columns by simply entering an arbitrary text into the textbox as in the search field. Click **+ Add next** to add another textbox if you want to filter for more than one term.

Apart from filtering for text there are several other options:

- In case of date fields (for example **Registration date**), you specify a date range to filter for.
- In the **Status** column you can filter for various criteria representing the send, push or maintenance status of the device.
- In the **Alarm** column the filtering options you may select correspond to the alarm types (critical, major, minor, warning, no alarms).
- For custom columns, select **Only rows where value is defined** to filter based on whether the fragment exists, or specify one or more filter terms the entry must match.

Finally, click **Apply** to carry out the filtering.

The devices list will now only display devices matching the filtering options.

Sorting is available on every column. Click the sort icon <i class="dlt-c8y-icon-sort-arrow icon-20"></i> in the respective column header once to sort the entries in ascending order and twice to sort the entries in descending order. Click the sort icon <i class="dlt-c8y-icon-sort-arrow icon-20"></i> once more to remove sorting for this column.

Click **Clear filters** in the table header if you want to clear all filters and view all devices.


> **Info:**
> If you select to sort a text field, for example, device name, in ascending or descending order, keep in mind that the resulting alphabetical sorting is based on ASCII/UTF: A < B < ... < Z < ... < a < b ... < z. Names starting with lower case letters will be sorted below all names with uppercase letters or vice versa.

## To replace a device

The device list supports the replacement of a physical device with another by preserving the original device representation in the platform including all its generated data. A wizard guides you through this process. Access the wizard by hovering over the device you want to replace in the device list and click the **Replace device** button.


> **Info:**
> Currently LWM2M devices are not supported and the **Replace device** button is not available for this type of devices.



In the **Replacement device** step you can see the list of devices available in the platform excluding the device which you are going to replace. Select a replacement device from the list.


> **Info:**
> In order for a particular replacement device to show up in the list, you must register it through the corresponding [registration process](https://cumulocity.com/docs/device-management-application/registering-devices/) for this device.



The **Select external IDs** step lists the external IDs assigned to the replacement device. Select those you want assigned to the device representation of the replaced device. You must select at least one external ID. This links the data which your new physical devices sends to the original device representation object.

Before proceeding with the actual replacement, you must confirm this action. Click **Replace** in the **Replace device** dialog.


> **Important:**
> The replacement process removes the replacement device from the Cumulocity database including all the data generated for it so far.



The **Replace** step displays the progress of the replacement process and the result of every step executed.

![Replace device](https://cumulocity.com/docs/images/users-guide/DeviceManagement/devmgmt-replace-device-wizard.png)<br>

If a step has been skipped you will find an icon with a tooltip which contains the reason why the step has been skipped.

If the execution of a given step has failed, you can see the error details by expanding the step details. Note that an error in one of the steps will not prevent the next steps from being executed. The wizard will try to execute as many steps as possible and provide information about failed steps. If you are able to resolve the reason for the failure(s), you can retry all failed steps by clicking the **Retry** button in the bottom bar. If you wish to retry a single failed step you can only do so by clicking the **Retry this step** button form the step actions dropdown.

The **Close** button brings you back the the updated device list. The replacement device will have been removed from Cumulocity while all data sent by the new physical device will be linked to the platform representation of the original device. This ensures that the physical replacement remains transparent to users.

In order to keep track of the replacements done for a given device an [event](https://cumulocity.com/docs/device-management-application/viewing-device-details/#events) and an [audit log](https://cumulocity.com/docs/standard-tenant/monitoring/#audit-logs) are created for every replacement.

## To delete a device from the list

1. Hover over the row of the device you want to delete.
2. Click the delete icon <i class="dlt-c8y-icon-editing-trash text-danger icon-20"></i> at the right of the row.
3. Confirm the device removal. Optionally, select whether to delete child devices of the device or to delete the associated device owner. Note that it is not possible to select both options.

The device will be permanently deleted from the platform.


> **Important:**
> Deleting a device means to remove the device from the Cumulocity database including all its generated data. Alternatively, you can arrange all retired devices in one group, see [Grouping devices](https://cumulocity.com/docs/device-management-application/grouping-devices)). This ensures that all reports remain correct. To prevent alarms from being raised for the retired devices, disable [connection monitoring](https://cumulocity.com/docs/device-management-application/monitoring-and-controlling-devices/#connection-monitoring). Deleting a device does not delete the data of its child devices.
