# Tags

With tags, you can label and categorize content in BuildingPro Suites. The following content can be tagged:

* Assets
* Users
* Rules

Content can be tagged with any number of tags. By tagging content with multiple tags, content can be easily filtered.

Tags can be collected in *categories*.

Each tag has its own color. This allows tags to be visually distinguished.

Tags are used for many different functions. For example, in the [↗ ACL](https://doc.eliona.io/collection/neue-funktionen/acl-access-control-list) function, tags are used to regulate access to different areas of BuildingPro Suites.

## Overview

### Open Tag Management

<div data-full-width="true"><figure><img src="https://3489494878-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9GvUpaatBiReR43XFSMg%2Fuploads%2FlEyqbtGnA8O24iW5Pve1%2FDocs_Tags%201.png?alt=media&#x26;token=738c6912-2add-43c2-9952-5a06911dbe27" alt=""><figcaption></figcaption></figure></div>

In Tag Management, you can perform all actions related to tags. To open Tag Management, proceed as follows.

1. Click on **Engineering \[A]**
2. Click on **Tag Management \[B]**

   ▷ The "Tag Management" window opens

### Overview

<div data-full-width="true"><figure><img src="https://3489494878-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9GvUpaatBiReR43XFSMg%2Fuploads%2FP2wgeiMhl9veqnJDSHpJ%2FDocs_Tags%202.png?alt=media&#x26;token=587c75ff-4f9a-4fbf-95db-b244aad388e5" alt=""><figcaption></figcaption></figure></div>

<table data-full-width="true"><thead><tr><th width="54.33330281575519">Element</th><th width="202.39996337890625">Title</th><th>Details</th></tr></thead><tbody><tr><td><strong>[C]</strong></td><td>Symbol for a category</td><td>↗ Categories are marked with this symbol</td></tr><tr><td><strong>[D]</strong></td><td>Expand</td><td>This symbol appears next to categories. Click on this symbol to expand the category and see which tags are assigned to this category.</td></tr><tr><td><strong>[E]</strong></td><td>Tag symbol</td><td>Individual tags are marked with this symbol</td></tr><tr><td><strong>[F]</strong></td><td>"Name" column</td><td>This column displays the names of tags and categories</td></tr><tr><td><strong>[G]</strong></td><td>"Assets" column</td><td>This column shows how many assets the corresponding tag is assigned to.</td></tr><tr><td><strong>[H]</strong></td><td>"Users" column</td><td>This column shows how many users the corresponding tag is assigned to.</td></tr><tr><td><strong>[I]</strong></td><td>"Rules" column</td><td>This column shows how many rules the corresponding tag is assigned to.</td></tr><tr><td><strong>[J]</strong></td><td>"Class" column</td><td>This column displays the class of the tag</td></tr><tr><td><strong>[K]</strong></td><td>"Color" column</td><td>For tags: This column displays the color of the tag. ◈ You can select the color of a tag when creating the tag.</td></tr><tr><td><strong>[L]</strong></td><td>New Tag</td><td>Click here to ↗ create a new tag or ↗ create a new category.</td></tr><tr><td><strong>[M]</strong></td><td>Edit</td><td>Click to customize the corresponding tag or category</td></tr><tr><td><strong>[N]</strong></td><td>Delete</td><td>Click to delete the corresponding tag or category</td></tr><tr><td><strong>[O]</strong></td><td>Details of a category</td><td>↗ More info about categories</td></tr><tr><td><strong>[P]</strong></td><td>Favorite</td><td>Click to mark the corresponding category as a favorite or to remove the mark.</td></tr><tr><td><strong>[Q]</strong></td><td>Sequence display</td><td>Shows the position in the sequence where the corresponding category is located</td></tr><tr><td><strong>[R]</strong></td><td>Open sequence selection</td><td>Click to open the sequence selection <strong>[S]</strong> for the corresponding category.</td></tr><tr><td><strong>[S]</strong></td><td>Sequence selection</td><td>Click on a value to sort the category into the corresponding position in the sequence.</td></tr></tbody></table>

## Create a New Tag

<figure><img src="https://3489494878-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9GvUpaatBiReR43XFSMg%2Fuploads%2FACq7MvkgNeiYh0Q9S7WL%2FDocs_Tags%204.png?alt=media&#x26;token=9c0e304b-a85a-4fe7-a1b5-b2e78c346ba0" alt=""><figcaption></figcaption></figure>

Proceed as follows to create a new tag.

1. Open the [↗ Tag Management](#open-tag-management)
2. Click on **\[L]**

   ▷ The window **\[T]** opens
3. In **\[U]**, select whether the tag should be created in an existing category **\[U1]**, ⇄ **OR** a new category should be created **\[U2]** ⇄ **OR** the tag should not be assigned to any category **\[U3]**.
4. If \[U1] or \[U2] was selected: In **\[V]**, select which category the tag should be assigned to, or specify the name for a new category.
5. In **\[W]**, enter a name for the new tag
6. In **\[X]**, select a color for the new tag
7. Click on **\[Y]** to add the tag and close the window \[T] ⇄ **OR** click on **\[Z]** to cancel ⇄ **OR** click on **\[AA]** to create the tag, leave the window open, and create another tag.

## Categories

Tags can be organized into categories. These categories are primarily needed to determine which tags are displayed in the [↗ Alarm Overview](https://docs.buildings.ability.abb/collection/platform/live-cockpit/widgets/predefined-widgets/alarm-overview).

Categories exist in a certain order. This order is called a sequence. **\[Q]**.

### Create a New Category

To create a new category, proceed as described in[ ↗ Create a New Tag](#create-a-new-tag). In step 3, select the option **\[U2]**.

### Move Tags into a New Category

You can drag and drop tags into a category using [↗ Drag and Drop](https://docs.buildings.ability.abb/collection/preface/user-interface-elements#dragn-drop)

### Mark Categories as Favorite

<figure><img src="https://3489494878-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9GvUpaatBiReR43XFSMg%2Fuploads%2Fiv6J5cG2GgdsHTu3Avx0%2FDocs_Tags%203.png?alt=media&#x26;token=c3553410-8cbb-4c1b-8aa0-5ff8e766ee8c" alt=""><figcaption><p>Left: The category is marked as a favorite. Right: The category is not marked as a favorite</p></figcaption></figure>

This function is important for the Alarm Overview. In the Alarm Overview, only tags are displayed for which all of the following conditions are met:

* The tag is in a category
* The category in which the tag is located is marked as a favorite

1. Click on **\[P]** to mark a category as a favorite
2. Click on **\[P]** again to remove the favorite mark

### Arrange Categories in an Order

This function is important for the Alarm Overview. By arranging categories in a specific order, you can determine the order in which tags are displayed in the Alarm Overview.

Click on **\[R]** and select the position in the sequence from **\[S]**.

## Tags Without Access

{% hint style="info" %}
Only applies to users whose role has the [↗ Expert Mode](https://docs.buildings.ability.abb/collection/mandatory-base/platform-core/roles/tenant-roles#c-the-expert-mode) activated.
{% endhint %}

Tags to which a user has no access are marked with a red dot.

<figure><img src="https://3489494878-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9GvUpaatBiReR43XFSMg%2Fuploads%2FnwiVllGMo0lZ7vOZwMGv%2FTag%20ohne%20Access.png?alt=media&#x26;token=a2b41c48-a4b9-441c-9b64-cc84e5fef45a" alt="" width="375"><figcaption></figcaption></figure>