Asset Management

Asset Attributes

Attach custom key-value metadata to any asset using the EAV pattern.

Asset attributes let you store arbitrary metadata on any asset as key-value pairs. This is useful for recording specifications, configuration parameters, or any other information that does not fit into the standard asset fields.

How attributes work

Attributes follow an Entity-Attribute-Value (EAV) pattern:

  • Entity — the asset
  • Attribute — a string key (e.g., rotor_diameter, rated_power)
  • Value — any JSON-compatible value

Each attribute key must be unique per asset. You can have as many attributes as needed.

Supported value types

Attribute values are stored as JSON, so they support all standard JSON types:

TypeExample
String"active", "rotor-type-a"
Number123, 45.67
Booleantrue, false
Nullnull
Object{"value": 120, "unit": "m"}
Array["tag1", "tag2"]

Managing attributes

Attributes are managed from the Attributes tab on the asset detail page.

Adding an attribute

Click Add Attribute and fill in the form:

  • Key — a descriptive identifier for the attribute (e.g., rotor_diameter, capacity_mw)
  • Value (JSON) — the attribute value as valid JSON. This can be a simple value like 120 or "active", or a structured value like {"value": 120, "unit": "m"}

The value field accepts any valid JSON. Enter strings with quotes ("active"), numbers without quotes (120), and objects or arrays with standard JSON syntax.

Editing an attribute

Click the edit action on an existing attribute to update its value. The key cannot be changed — if you need a different key, delete the attribute and create a new one.

Deleting an attribute

Click the delete action and confirm. The attribute is removed from the asset.

Common use cases

  • Technical specifications — rated power, flow capacity, operating pressure, dimensions
  • Installation details — serial number, firmware version, installation date
  • Operational parameters — threshold values, calibration factors
  • Custom metadata — tags, notes, external system references
// Example attributes for a centrifugal pump
{ "key": "rated_power_kw", "value": 75 }
{ "key": "max_flow_m3h", "value": 350 }
{ "key": "max_pressure_bar", "value": 16 }
{ "key": "manufacturer", "value": "Grundfos" }
{ "key": "model", "value": "NK 100-250" }
{ "key": "serial_number", "value": "PMP-2024-001" }

Site-level attributes (such as site category, location, and operational status) are also stored as attributes internally, but they are managed through the site configuration interface rather than the attributes tab.

On this page