Edit data field labels
- Last UpdatedJun 26, 2025
- 2 minute read
Edit data field labels to create a friendly name for a field that displays in your data view.
Data field labels
A data field label is a friendly name that you can specify directly or using rules. Null, empty, or whitespace is not allowed for a data field label.
When the data view is resolved and data fields produce field mappings, labels are trimmed of whitespace and used as the field mappings' identifier. For example:
| Timestamp | Power In Value | Power Out Value |
In cases where the identifiers are not unique, the identifier is suffixed with an ordinal number, its position. For example:
| Timestamp.0 | Value.1 | Value.2 |
To edit data field labels, enter { to display tokens to use as a data field label. There are a variety of special tokens available for use in field labels. These tokens resolve to a specific value for a field. The following list describes each available token.
|
Token |
Description |
|---|---|
|
{AccountId} |
The identifier of the account where the corresponding stream originates from. |
|
{AccountName} |
The name of the account where the corresponding stream originates from. |
|
{IdentifyingValue} |
The value of the identifying field. |
|
{InstanceId} |
The identifier of the service instance where the corresponding stream originates from. |
|
{InstanceName} |
The name of the service instance where the corresponding stream originates from. |
|
{Key} |
The value of the first of the Key objects specified on the field. |
|
{QueryId} |
The identifier of the query that produced the field. |
|
{StreamReferenceName} |
The value of the first of the StreamReferenceName objects specified on the field. |
|
{SummaryDirection} |
The value of the summary direction of the field (if summary type is defined). |
|
{SummaryType} |
The value of the summary type of the field (if defined). |
|
{Uom} |
The value of the unit of measure of the field (if UOM is present in the source). |
If a special parameter fails to resolve, it becomes an empty string, "".
To edit data field labels
-
From the Data Field Label field, enter one or more tokens to use as a label. At the time of data view resolution, the labels resolve to values pulled from the data item (stream). For more information on each available token, see the table above.
-
(Optional) Select the Include UOM as a Column checkbox. This option includes the unit of measure as a column in your data view.
-
(Optional) Select a Summary direction. This option controls whether the start or end index of the summary is used by the data view to calculate the summary values.
-
Review the Data Field Preview. This preview lists each data field and property included within the affected data view queries.
-
Select Apply.