> 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/adding-an-asset.md).

# Adding an Asset

Add a new asset (device) to your organization.

{% hint style="info" %}
An asset is always created from an **Asset Template** (formerly *Device Type*). Make sure the template exists before adding the asset, see [Device Types](https://docs.widgelix.com/get-started/device-types.md).
{% endhint %}

The asset template provides the general settings of the asset: decoder (uplink payload formatter) and data fields, downlink formatter, dashboard widgets and list widgets. Individual settings such as connectivity, time zone, online threshold, coordinates and meta tag values are configured per asset.

## Add an asset

1. Go to **Assets** and click **+ Add asset**.
2. Fill in the form:

<figure><img src="https://2494440469-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fggsr9Xlsze5cwVr4WMof%2Fuploads%2FdssZ7AXks2ieWUz36hWy%2Fadd-asset.png?alt=media&amp;token=b9cf11b2-8851-4e32-b064-a7d7938bf563" alt="Add Asset form" width="480"><figcaption><p>Add Asset form</p></figcaption></figure>

| Field                 | Description                                                                                                                                        |
| --------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Name**              | A descriptive name, e.g. `Cold-Room-01`.                                                                                                           |
| **Asset Id (DevEUI)** | Unique device identifier, for LoRaWAN devices the DevEUI as a HEX string, e.g. `0004A310001AB115`.                                                 |
| **Asset Template**    | Template the asset is based on.                                                                                                                    |
| **Asset Location**    | Turn on to enter **Latitude** and **Longitude**, or pick the position on a map. The location is used by the Map, map widgets and geofence actions. |

3. Choose a **data retention plan** for the asset. Plans differ in how long data is stored: **Free** (7 days), **Basic** (30 days), **Standard** (180 days) and **Advanced** (365 days). Current prices are shown in the form.

{% hint style="info" %}
**Asset Limit:** up to 5 assets can be connected free of charge for non-commercial deployments.
{% endhint %}

4. Save the asset. It now appears in the [Assets list](https://docs.widgelix.com/assets/assets-list.md).

## Next steps

* Configure **Connectivity** in the asset's [Settings](https://docs.widgelix.com/assets/asset-page/settings.md) tab so that Widgelix receives the asset's uplinks.
* Fill in meta tag values (location, room, floor...) in the **Meta** tab.
* Configure [List Widgets](https://docs.widgelix.com/assets/list-widgets.md) for the template if they are not configured yet.
