Assets

Assets are abstract entities in ThingsBoard that represent physical objects, spaces, or organizational units — buildings, rooms, production areas, fields, streetlights, substations, or vehicles. Unlike devices, assets don’t generate telemetry on their own but can aggregate data from related devices and participate in rule chains, alarms, and dashboards.

1. Navigate to Entities → Assets.
2. Click + and select Add new asset.
3. Enter a Name (must be unique within the tenant).
4. Optionally select an Asset profile (defaults to “default”), Label, or Description.
5. Click Add.

1. Click the asset in the list to open its details.
2. Click the pencil icon.
3. Update the name, label, profile, or description.
4. Click Apply changes.

Click the trash icon next to the asset and confirm, or open the asset details page and click Delete asset.

1. Locate the asset in the list.
2. Click the Assign to customer icon.
3. Select the target customer and click Assign.

Only users associated with that customer can access the asset and its data. You can later unassign or reassign the asset to another customer.

Click the Make asset public icon next to the asset to expose its data publicly, or Make asset private to revoke public access.

Opening an asset reveals a details panel with the following tabs:

Tab	Contents
Attributes	Client, server, and shared key-value pairs (location, category, configuration parameters)
Latest Telemetry	Telemetry propagated from related devices, aggregated via calculated fields, or added manually; supports manual entry and deletion
Calculated Fields	Values computed from telemetry or attributes using formulas
Alarm Rules	Conditions, thresholds, and triggers configured for alarm generation
Alarms	Active and historical alarms for this asset
Events	Lifecycle events, logs, warnings, and errors
Relations	Directed connections to other entities (devices, assets, dashboards, rule chains)
Audit Logs	History of user actions: creation, updates, deletions
Version Control	Git-based export and restore for backup and collaboration

You can create, view, edit, and delete relations between an asset and other entities from the Relations tab of the asset details page.

Add a relation:

1. Open the asset details → Relations tab.
2. Select the direction: From (outbound) or To (inbound).
3. Click +.
4. Set the Relation type (e.g., Contains, Manages) and choose the target entity.
5. Click Add.

• Dashboards — visualize aggregated data, attributes, and alarms via widgets
• Rule Engine — process attribute updates, trigger alarms, route messages
• Calculated Fields — compute derived values by aggregating data from related devices
• Relations — model hierarchies (e.g., Building → Contains → Room → Contains → Sensor)
• REST API — query, create, and manage assets programmatically