Skip to main content

Upload reference: Metrics tab

Columns, rules and examples for the Metrics tab of the upload workbook.

Columns

All seven columns are required on every row.

Column

Description

Example

name

Metric identifier

floor_area

title

Display name

Office Size

tag_name

The tag or trait it applies to, in type:name format

facility:denver-office

unit

Unit of measure

sq_ft

value

The number

42000

measurement_interval

How often it's measured

year

measured_at_period

The period the value is for

year[2025]

Key: name + tag_name + measured_at_period

Example

name

title

tag_name

unit

value

measurement_interval

measured_at_period

floor_area

Office Size

facility:denver-office

sq_ft

42000

year

year[2025]

floor_area

Warehouse Size

facility:denver-warehouse

sq_ft

85000

year

year[2025]

fte

Full-Time Employees

business_unit:west

count

320

year

year[2025]

Rules

  • Use the tag's name in tag_name, not its title.

  • Re-uploading the same name, tag and period updates the value. A different period creates a new value.

Did this answer your question?