Import & Export

Templates can be exported as JSON files and imported into other Fleetera organizations. This is useful for sharing standardized asset definitions, creating backups, or setting up new tenants with pre-built templates.

Exporting a template

On the template detail page, click Export Template. The entire template — including its metadata, variable definitions, and child template hierarchy — is downloaded as a JSON file named [alias]-template.json.

Import format

The JSON file follows this structure:

{
  "schemaVersion": "1.0",
  "name": "Centrifugal Pump - Model X200",
  "alias": "centrifugal-pump-model-x200",
  "category": "centrifugal_pump",
  "description": "Standard centrifugal pump template with motor and seal subsystems",
  "variables": [
    {
      "key": "discharge_pressure",
      "name": "Discharge Pressure",
      "kind": "raw",
      "dataType": "Float64",
      "unitCode": "bar",
      "samplingHintMs": 1000,
      "isIndex": false,
      "description": "Pump discharge pressure"
    }
  ],
  "children": [
    {
      "schemaVersion": "1.0",
      "name": "Drive Motor",
      "alias": "drive-motor",
      "category": "motor",
      "variables": [],
      "children": []
    }
  ]
}

Required fields

Field	Description
`schemaVersion`	Must be `"1.0"`
`name`	Template display name
`alias`	Unique identifier (lowercase, hyphens)
`category`	Asset category alias

Optional fields

Field	Description
`description`	Template description
`variables`	Array of variable definitions
`children`	Array of child templates (same structure, recursive)

Variable definition fields

Field	Required	Description
`key`	Yes	Machine-readable identifier in `snake_case`
`name`	Yes	Human-readable label
`kind`	Yes	`"raw"` or `"derived"`
`dataType`	Yes	Data type (e.g., `"Float64"`, `"Int32"`, `"Boolean"`, `"String"`)
`unitCode`	No	Unit of measurement (e.g., `"kW"`, `"°C"`, `"rpm"`)
`samplingHintMs`	No	Suggested sampling interval in milliseconds
`isIndex`	No	Whether this variable is an index/identifier
`description`	No	Description of the variable

Importing a template

On the templates list page, click Import. In the dialog, upload a JSON file by dragging and dropping or clicking to browse. Only .json files are accepted.

Before importing, the platform validates the file and shows a preview:

Template name
Number of child templates
Number of variable definitions
Any validation errors (missing required fields, invalid format)

On confirmation, the import creates:

The root template and all child templates recursively
All variable definitions on each template
Parent-child relationships between templates

A summary shows the total number of templates and variables created.

If a template with the same alias already exists in your organization, the import will fail with a conflict error. Rename the alias in the JSON file before re-importing.

Schema and example files

The templates list page provides two reference downloads:

Download Schema — the JSON schema file that defines the expected structure of a template file
Download Example — a sample template JSON file that you can use as a starting point