> For the complete documentation index, see [llms.txt](https://docs.widgelix.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.widgelix.com/assets/assets-list.md).

# Assets List

Overview of the Assets page (formerly Devices) - KPIs, filters, list and cards views, and row actions.

**Assets** (formerly **Devices**) are the sensors, meters, trackers and other things connected to Widgelix. Every asset is based on an **Asset Template** (formerly *Device Type*), which defines its decoder, data fields, dashboard widgets and list widgets.

Click **Assets** in the left sidebar to open the list of all assets of the current organization.

<figure><img src="https://2494440469-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fggsr9Xlsze5cwVr4WMof%2Fuploads%2FQqrutqGGkaaN0EwBogYP%2Fassets-list.png?alt=media&amp;token=18f5c5b5-2696-4841-b7c9-035c3992c349" alt="Assets list"><figcaption><p>Assets list, List view (demo data)</p></figcaption></figure>

## KPI tiles

The tiles at the top summarize the assets that match the current filter:

| Tile                | Shows                                                                                                                                                                |
| ------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Total assets**    | Number of assets in the current filter.                                                                                                                              |
| **Online**          | Assets that reported within their online threshold, with the share of the fleet.                                                                                     |
| **Offline**         | Assets that did not report within their online threshold (*Needs attention*).                                                                                        |
| **Low battery**     | Assets whose battery level is **15 % or less**. Requires the battery indicator to be configured in [List Widgets](https://docs.widgelix.com/assets/list-widgets.md). |
| **Critical events** | Critical (Danger) events in the last 24 hours.                                                                                                                       |

The tiles are recalculated whenever you change a filter.

## Search and filters

* **Search by name or ID**: finds assets by name or by asset ID (DevEUI).
* **Asset template**: shows only assets of one template.
* **Tag**: filters by a meta tag value, e.g. a room number or address (see [Meta](https://docs.widgelix.com/assets/asset-page/meta.md)).
* **All / Online / Offline**: status filter with counters.
* **Fit screen / Expand**: fit the table into the window or expand it to the full page height.
* **List / Cards**: switch between the table and the card view.

## List view

| Column          | Description                                                                                                                                                                                                                               |
| --------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Asset**       | Name (click to open the [asset page](https://docs.widgelix.com/assets/asset-page.md)), asset template, optional meta tag (e.g. `room: 1020`) and the asset ID with a copy button. The coloured dot on the avatar shows the online status. |
| **Status**      | **Online** / **Offline** and the time of the last uplink (e.g. *9 minutes ago*).                                                                                                                                                          |
| **Last values** | Up to three latest values with units and an optional sparkline. Shows **Not configured** until list widgets are set up for the asset template.                                                                                            |
| **Battery**     | Battery level in percent, if the battery indicator is configured.                                                                                                                                                                         |
| **Last event**  | Severity badge, message and time of the most recent event of the asset.                                                                                                                                                                   |

Use **Rows per page** and the pagination at the bottom to browse large fleets.

## Cards view

The **Cards** view shows the same information as tiles, which is handy on large screens or for a quick visual check of a site. The top border of each card is green for online and red for offline assets.

<figure><img src="https://2494440469-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fggsr9Xlsze5cwVr4WMof%2Fuploads%2FLtCa4AisnG1QkEQZ1BYt%2Fassets-cards.png?alt=media&amp;token=ec52633a-c983-41a5-905c-69d6266ea85f" alt="Assets cards view"><figcaption><p>Cards view</p></figcaption></figure>

## Row menu

Click the **⋮** button at the end of a row (or on a card) to open the asset menu:

<figure><img src="https://2494440469-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fggsr9Xlsze5cwVr4WMof%2Fuploads%2FnLKL2Fcx2xQvR94xqSWk%2Frow-menu.png?alt=media&amp;token=43f10e02-00e9-41e0-9e0a-2e5ca9273c71" alt="Asset row menu"><figcaption><p>Asset row menu</p></figcaption></figure>

* **Open asset**: opens the [asset page](https://docs.widgelix.com/assets/asset-page.md).
* **Copy ID**: copies the asset ID (DevEUI) to the clipboard.
* **Configure list widgets**: defines which values, sparkline, battery indicator and meta tag are shown for all assets of this asset template. See [List Widgets](https://docs.widgelix.com/assets/list-widgets.md).
* **Delete asset**: removes the asset from the organization. This cannot be undone.

## Adding assets

Click **+ Add asset** in the top right corner. See [Adding an Asset](https://docs.widgelix.com/assets/adding-an-asset.md).
