> 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/list-widgets.md).

# List Widgets

Choose which values, sparkline, battery indicator and meta tag are shown for an asset template in the Assets list.

**List widgets** control what the [Assets list](https://docs.widgelix.com/assets/assets-list.md) shows in the **Last values** and **Battery** columns (and on the cards) for every asset of an asset template. They are saved **in the asset template**, so you configure them once and they apply to all assets based on it, including assets added later.

Until list widgets are configured, the assets of a template show **Not configured** in the Last values column.

## Open the configuration

1. Go to **Assets**.
2. Click the **⋮** button of any asset of the template you want to configure.
3. Choose **Configure list widgets** (the menu shows which template will be changed, e.g. *Template: generic-node*).

<figure><img src="https://2494440469-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fggsr9Xlsze5cwVr4WMof%2Fuploads%2FVvqxXxrHNjVfLwmpYISg%2Flist-widgets-modal.png?alt=media&amp;token=7bf305b8-aa2a-4159-aa68-95f805dd69ce" alt="List widgets dialog"><figcaption><p>List widgets dialog</p></figcaption></figure>

The header of the dialog confirms the template and how many assets the change applies to, e.g. *Asset template generic-node · applies to 51 assets. Saved in the template.*

## Fields to show

Select **up to 3** data fields of the template. Each field is shown with its unit (e.g. `temperature °C`, `humidity %`, `batteryVolt V`). Fields marked **Empty** have not received any data yet.

The selected fields appear in the Last values column in the order you select them.

## Sparkline

Adds a small trend chart of the **last 24 uplinks** under one of the selected fields.

* **None**: no sparkline.
* Select one of the fields chosen above to draw its trend.
* **Line** or **Bars**: chart style. Bars suit discrete values such as states, detections or counts.

## Battery indicator

Turn on **Battery indicator** to show a battery icon and percentage in the Battery column for every asset of the template.

| Setting          | Description                                                                                  |
| ---------------- | -------------------------------------------------------------------------------------------- |
| **Source field** | Data field that carries the battery value, e.g. `batteryVolt`.                               |
| **Min (0 %)**    | Value that corresponds to an empty battery, e.g. `0` (or the cut-off voltage of the device). |
| **Max (100 %)**  | Value that corresponds to a full battery, e.g. `3.6` V.                                      |

Widgelix converts the reported value to a percentage between Min and Max. If the device already reports the battery in percent, use `0` and `100`. Assets at **15 %** or below are counted in the **Low battery** KPI tile.

## Meta tag

Choose one [meta tag](https://docs.widgelix.com/assets/asset-page/meta.md) of the template (e.g. `room`, `floor`, `address`) to show under the asset name, for example `room: 1020`. The tag is displayed only for assets where it has a value. Select **None** to hide it.

## Preview and save

The **Preview** at the bottom shows how a row will look with sample values.

* Click **Save to template** to apply the configuration to all assets of the template.
* Click **Cancel** to close without changes.
* **Open asset template** opens the template itself.

{% hint style="info" %}
Assets of different templates can show different fields in the same list. Configure list widgets once per asset template.
{% endhint %}
