---
title: "Edit and Manage Tags"
slug: "edit-and-manage-tags"
updated: 2026-03-27T16:17:33Z
published: 2026-03-27T16:17:33Z
canonical: "docs.sightmachine.com/edit-and-manage-tags"
---

> ## Documentation Index
> Fetch the complete documentation index at: https://docs.sightmachine.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Edit and Manage Tags

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.

![](https://cdn.us.document360.io/c65001f1-30e3-4f1d-b335-57abf64ebd31/Images/Documentation/image(330).png)

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.

![](https://cdn.us.document360.io/c65001f1-30e3-4f1d-b335-57abf64ebd31/Images/Documentation/Untitled design (39).gif)

💡 **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**.

![](https://cdn.us.document360.io/c65001f1-30e3-4f1d-b335-57abf64ebd31/Images/Documentation/image(332).png)

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**.

![](https://cdn.us.document360.io/c65001f1-30e3-4f1d-b335-57abf64ebd31/Images/Documentation/image(333).png)

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.

![](https://cdn.us.document360.io/c65001f1-30e3-4f1d-b335-57abf64ebd31/Images/Documentation/image(334).png)

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.

![](https://cdn.us.document360.io/c65001f1-30e3-4f1d-b335-57abf64ebd31/Images/Documentation/image(335).png)

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.

![](https://cdn.us.document360.io/c65001f1-30e3-4f1d-b335-57abf64ebd31/Images/Documentation/Untitled design (40).gif)

📝 **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.