Edit and Manage Tags

Prev Next

View, filter, sort, and edit tag properties directly in the Control Plane tag table.

View Tags

  1. Select a facility, line, machine type, or machine in the navigation tree to scope the tag list.

    1. Selecting a facility shows all tags across all machines in that facility

    2. Selecting a machine type shows all tags for machines of that type

    3. Selecting an individual machine shows only that machine's tags

  2. Select the Tags tab in the header.

The tag table displays one row per tag. Tag fields fall into two categories — schema fields that define the tag's identity and data structure, and semantic fields that control how the tag appears in analytics. This distinction matters because changes to each category have different downstream effects (see Impact on Pipelines below).

Schema fields — define tag identity, data structure, and pipeline behavior. Changes to these fields put dependent pipelines into edit mode.

Column

Required

Machine

The machine this tag belongs to

Source

Data source identifier (topic)

Name

Internal tag identifier

Raw Tag Name

Original tag name from the data source

Data Type

Tag value type (e.g., double, Text, boolean)

Aggregate

Default aggregation method (e.g., avg, min, max, sum)

Forward Fill

Whether missing values are forward-filled

Semantic fields — control how the tag appears in analytics views. Changes to these fields take effect immediately without triggering pipeline edit mode.

Column

Required

Display Name

Human-readable label shown in charts, tables, and selectors

Default Aggregation

Override for the default aggregation method (avg, min, max, sum, first, last)

Stat Type

How the platform classifies the tag (Categorical, Continuous, Discrete, Epoch, Date, Datetime)

Display Hide

Whether the tag is hidden from analytics views

Unit of Measure

Unit label; time units enable automatic unit conversion

Scale of Measure

Scale label for the tag

Filter and Sort Tags

  • Filter: Select the filter controls at the top of the tag table, choose a column, and enter or select a value. The table updates to show only matching tags.

  • Sort: Select any column header to sort ascending, then again for descending.

💡 Tip: Filters are especially useful when a facility has hundreds or thousands of tags. Filter by machine or machine type to focus on the tags you need to edit.

Add and Remove Tags

To add an individual tag without uploading a CSV:

  1. Select an asset in the navigation tree and switch to the Tags view.

  2. Select the + button in the tag table header to open the actions menu.

  3. Select Add Row.

  1. A new empty row appears in the table. Fill in the tag fields (name, source, raw tag name, display name, data type, aggregate, forward fill) directly in the row.

To remove a tag, select the delete icon on the row you want to remove.

📝 Note: For adding many tags at once, uploading a CSV (see Upload Files above) is faster than adding them one at a time.

Add and Remove Custom Columns

The tag list comes with a set of enforced columns (see schema and semantic fields above), but you can also add custom columns to track additional tag metadata specific to your operation.

To add a custom column:

  1. Select the + button in the tag table header to open the actions menu.

  2. Select Add Column.

  1. In the Add Column modal, enter:

    1. Column Name — a unique name for the column

    2. Data Type — the data type for the column values

  2. Select Add Column to confirm.

The new column appears in the tag table and can be populated for each tag.

To remove a custom column, select the delete icon on the column header.

📝 Note: Custom columns are stored as part of the tag list data dictionary. Adding or removing columns is a schema change that puts dependent pipelines into edit mode. Enforced columns (machine, source, name, raw_tag_name, etc.) cannot be removed.

Download Tags as CSV

To export the current tag list as a CSV file:

  1. Switch to the Tags view.

  2. Select the Download CSV icon in the toolbar.

The downloaded file contains the complete tag list for the workspace, in the same column format used for uploads. This is useful for making bulk edits offline or for creating a backup before changes.

Edit a Tag Inline

  1. Locate the tag you want to edit (use filters or sort to find it).

  2. Select the cell you want to modify.

  3. Enter the new value or select from the available options.

  4. The change is applied when you move to the next cell or confirm the edit.

📝 Note: The Machine, Source, Name, and Raw Tag Name columns identify the tag and cannot be changed inline. To modify these values, delete the tag and create a new one with the correct values, or re-upload a corrected CSV.

💡 Tip: Editing a semantic field (like Display Name, Default Aggregation, Unit of Measure, or Stat Type) takes effect immediately in analytics without requiring a pipeline redeployment. Editing a schema field (like Data Type or Aggregate) changes the tag list data dictionary, which puts dependent pipelines into edit mode — a redeployment is required to apply those changes.