Variable Libraries
Browse and clone from curated collections of standardized variables.
Variable libraries are reusable collections of variable definitions grouped by industry or equipment type. They help you standardize variable naming, data types, and units across your organization.
Library types
Platform libraries
Pre-defined by Fleetera and available to all tenants. These cover standard measurement points for common industrial equipment — for example, variables for pumps and motors, HVAC systems, or energy metering based on industry standards.
Platform libraries are read-only. You cannot modify or delete them.
Tenant libraries
Custom libraries that you create for your organization. Use them to define company-specific variable sets, proprietary measurement points, or standardized naming conventions. Tenant libraries are only visible within your organization and can be fully managed.
Library structure
Each library contains:
| Field | Description |
|---|---|
| Name | Library display name (e.g., "Pump and Motor Variables") |
| Category | Industry or equipment group (e.g., energy, manufacturing, HVAC, general) |
| Description | Explanatory text about the library and its source |
| Version | Version identifier (e.g., "1.0", "IEC 61400-25-2") |
| Source URL | Optional reference link to the standard or specification |
| Variables | Array of variable definitions |
Each variable in a library has:
| Field | Required | Description |
|---|---|---|
| Key | Yes | snake_case identifier (e.g., active_power) |
| Name | Yes | Display name (e.g., "Active Power") |
| Data Type | Yes | Boolean, Int32, UInt32, Float, Double, or String |
| Unit Code | No | Unit of measurement (e.g., kW, °C) |
| Sampling Hint (ms) | No | Suggested collection interval (minimum 100ms) |
| Is Index | Yes | Whether this is an index column |
| Description | No | What this variable represents |
Browsing libraries
Navigate to Libraries in the sidebar to see all available libraries. The list shows:
- Library name and description
- Category badge
- Variable count
- Source indicator (platform or tenant)
- Version number
Click a library to view its variables. You can search and filter variables by key, name, or description.
Cloning variables to a template
To add library variables to a template:
- Open the template detail page and go to the Variables tab
- Click Add from Library
- In the dialog, select a library from the left panel
- Browse or search variables in the right panel
- Select the variables you want (use checkboxes or Select All)
- Click Add to clone the selected variables into the template
The platform skips variables with duplicate keys and reports how many were added versus skipped. If the new variables differ from the latest template version, a new version is automatically created.
Cloning copies the variable definitions into the template. Changes to the library after cloning do not affect the template — the copies are independent.
Managing tenant libraries
For tenant libraries you own, you can:
- Add variables — define new variables with key, name, data type, unit, and other properties
- Update variables — change name, data type, unit code, sampling hint, or description
- Remove variables — delete individual variables from the library
- Bulk import — import variables in bulk with three modes:
- Replace — delete all existing variables and add new ones
- Append — add new variables, skip duplicates
- Merge — update existing variables and add new ones
- Export — download the library as JSON for backup or sharing