# tags

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

* Assets
* User
* Rules

Content can be assigned any number of tags. By assigning multiple tags to content, content can be filtered easily.

Tags can be collected in *categories* groups.

Each tag has its own color. This makes it possible to visually distinguish tags.

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

## Overview

### Open tag management

<div data-full-width="true"><figure><img src="https://content.gitbook.com/content/Nyvwhz1kEMXcHf4HLuZ8/blobs/Bar2mFtX7XdvwTZl3XFV/Docs_Tags%201.png" alt=""><figcaption></figcaption></figure></div>

In tag management, you can perform all actions related to tags. Proceed as follows to open tag management.

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://content.gitbook.com/content/Nyvwhz1kEMXcHf4HLuZ8/blobs/nCWd9tD8ANpFLwY85UBm/Docs_Tags%202.png" alt=""><figcaption></figcaption></figure></div>

<table><thead><tr><th width="130.33333333333331">Element</th><th>Title</th><th>Details</th></tr></thead><tbody><tr><td><strong>[C]</strong></td><td>Category symbol</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 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>Column "Name"</td><td>This column displays the names of tags and categories</td></tr><tr><td><strong>[G]</strong></td><td>Column "Assets"</td><td>This column shows how many assets the corresponding tag is assigned to.</td></tr><tr><td><strong>[H]</strong></td><td>Column "Users"</td><td>This column shows how many users the corresponding tag is assigned to.</td></tr><tr><td><strong>[I]</strong></td><td>Column "Rules"</td><td>This column shows how many rules the corresponding tag is assigned to.</td></tr><tr><td><strong>[J]</strong></td><td>Column "Class"</td><td>This column shows the class of the tag</td></tr><tr><td><strong>[K]</strong></td><td>Column "Color"</td><td>For tags: This column shows 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 edit 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>Category details</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 remove the favorite mark.</td></tr><tr><td><strong>[Q]</strong></td><td>Sequence display</td><td>Shows the position of the corresponding category in the sequence</td></tr><tr><td><strong>[R]</strong></td><td>Open sequence selection</td><td>Click to open the sequence selection <strong>[S]</strong> of the corresponding category.</td></tr><tr><td><strong>[S]</strong></td><td>Sequence selection</td><td>Click a value to assign the category to the corresponding position in the sequence.</td></tr></tbody></table>

## Create a new tag

<figure><img src="https://content.gitbook.com/content/Nyvwhz1kEMXcHf4HLuZ8/blobs/mycKnXDlBOFVamR9yCwM/Docs_Tags%204.png" alt=""><figcaption></figcaption></figure>

Proceed as follows to create a new tag.

1. Open the [↗ Tag Management](#tag-management-aufrufen) on
2. Click on **\[L]** \
   ▷ The window **\[T]** opens
3. Select in **\[U]** whether the tag should be created in an already 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 enter the name for a new category.
5. Enter in **\[W]** enter a name for the new tag
6. Select in **\[X]** select a color for the new tag
7. Click on **\[Y]**, to add the tag and close the \[T] window \
   ⇄ **OR** Click on **\[Z]**, to cancel \
   ⇄ **OR** Click on **\[AA]** to create the tag, keep the window open and create another tag.

## categories

Tags can be organized into categories. These categories are mainly used to determine which tags are displayed in the ↗ alarm overview.

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

### Create a new category

To create a new category, proceed as described in [↗ Create a new tag](#einen-neuen-tag-erstellen) Select the option in step 3 **\[U2]**

### Move tags into a new category

You can drag tags [↗ drag and drop](https://docs.buildings.ability.abb/collection/english-v14/foreword/controls#elemente-ziehen) into a category

### Mark categories as favorite

<figure><img src="https://content.gitbook.com/content/Nyvwhz1kEMXcHf4HLuZ8/blobs/c0bFiYmbLJg9J1kQ7vp7/Docs_Tags%203.png" alt=""><figcaption><p>Left: The category has been 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 those tags are displayed for alarms 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 again on **\[P]**, to remove the favorite mark

### Arrange categories in an order

This function is important for the alarm overview. By arranging categories in a certain order, you can determine the order in which tags are displayed in the alarm overview.

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

## Tags without access

{% hint style="info" %}
Applies only to users whose role has [↗ Expert Mode](https://docs.buildings.ability.abb/collection/english-v14/roles/project-roles#c-der-expert-mode) enabled.
{% endhint %}

Tags that a user does not have access to are marked with a red dot.

<figure><img src="https://content.gitbook.com/content/Nyvwhz1kEMXcHf4HLuZ8/blobs/bqNkIRa59RxfqOGXuD7T/Tag%20ohne%20Access.png" alt="" width="375"><figcaption></figcaption></figure>


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.buildings.ability.abb/collection/english-v14/documentation/tags.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.