> For the complete documentation index, see [llms.txt](https://scenegroup.gitbook.io/cavalry/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://scenegroup.gitbook.io/cavalry/user-interface/menus/window-menu/tags.md).

# Tags

Organise your scenes.

Tags can be assigned to Elements to provide a way to quickly make selections or filter the [Scene Window](/cavalry/user-interface/menus/window-menu/scene-window.md) and/ or [Viewport](/cavalry/user-interface/menus/window-menu/viewport.md). Tags can also be nested for extra control and clarity.

{% embed url="<https://youtu.be/23OGMtm7ZL0>" %}

### UI

**Mode** - the result of selecting a tag.

* **Select** - select all layers assigned with the selected tag(s).
* **Filter Scene Window** - show only layers assigned with the selected tag(s) in the [Scene Window](/cavalry/user-interface/menus/window-menu/scene-window.md).
* **Filter Viewport** - show only layers assigned with the selected tag(s) in the [Viewport](/cavalry/user-interface/menus/window-menu/viewport.md).
* **Filter Both** - show only layers with the assigned tag(s) in both the [Scene Window](/cavalry/user-interface/menus/window-menu/scene-window.md) and the [Viewport](/cavalry/user-interface/menus/window-menu/viewport.md).

**Clear Tag Selection (button)** - deselect all selected tags.

**Add Tag (button)** - add a new tag.

### Window

The tag window contains 3 types of tags:

* **Quicklist** - the quicklist can be thought of as a temporary tag. Its state is not saved with your scene.
* **System Tags** - auto-assigned tags based on **Label Color** and **Element Type**.
* **User Tags** - tags created by you.

### Managing Tags

#### Adding/ Removing Tags

Add tags by either:

* Clicking the `+` button at the top of the **Tag Window** then type the name of your tag and hit **Return/Enter**.
* Click `cmd/ctrl + Shift + t` in the [Scene Window](/cavalry/user-interface/menus/window-menu/scene-window.md) to bring up the **Add Tag** window. Type the name of your tag and hit **Enter/Return**. If you check **Assign Tag to Selection** any selected layers will also be assigned with the new tag.

{% hint style="info" %}
A quick way to **Assign Tag to Selection** is to hold `alt/option` as you hit **Return/Enter**. This will assign that tag to any selected Elements regardless of whether the checkbox is enabled or not.&#x20;
{% endhint %}

Remove tags by either:

* Selecting a tag and hitting the **Delete** key.
* Right click on a tag and choose **Delete Tag** from the contextual menu.

Deleting a tag will also un-assign it from any Elements.

#### Assigning/ Un-assigning Tags

Assign tags by either:

* Dragging and dropping an Element(s) from the [Scene Window](/cavalry/user-interface/menus/window-menu/scene-window.md) onto a tag.
* Check the **Assign Tag to Selection** option as you add a Tag.
* Click the `tag/label` icon in the [Scene Window](/cavalry/user-interface/menus/window-menu/scene-window.md) then type the name of your tag and hit **Return/Enter**.

Un-assign tags by either:

* Right click on an Element in the [Scene Window](/cavalry/user-interface/menus/window-menu/scene-window.md) and select **Remove Tag** from the contextual menu.
* Right click on a tag in the **Tag Window** and then select **Clear Tag**. Note - this will remove a tag from **all** Elements.&#x20;

#### Activating Tags

Simply select a tag in the Tag Window to activate it. You can use `cmd/ctrl` or `Shift` to select and/or deselect multiple tags.

{% hint style="info" %}
Holding `alt/option` as you drag Elements on to tags to assign them will also activate that tag on mouse up.
{% endhint %}

#### Renaming Tags

To rename a tag simply select one and hit **Return/ Enter**.

#### Quicklist

The Quicklist can be thought of as a temporary tag. It can be used as a way to quickly solo a selection of Elements. Its contents are only saved during a session and not saved with your scene.

You can convert the Quicklist into a tag by right clicking anywhere in the **Tag Window** and choosing the **Convert Quicklist to Tag** option in the contextual menu.

#### Nested Tags

You can create relationships between Tags by nesting them on creation. To do this type a `/` (Forward Slash) between tags. e.g. `Character/Body` will create two tags called **Character** and **Body** with **Body** as a child of **Character**. Selecting **Character** will select all elements with both the **Character and Body** tags assigned to them whereas selecting **Body** will only select the Elements with **Body** assigned to them.

{% hint style="success" %}
When setting up a **Character** you might create a hierarchy as follows:

* Character
  * Head
    * Hair
    * Ears
    * Eyes
    * Nose
    * Mouth
  * Body
    * Arms
      * Hands
    * Legs
      * Feet

Selecting **Head** would then show you the entire head including the hair, ears, eyes, nose and mouth. Be as granular as you like!
{% endhint %}

If a tag already exists then a child can be added to it by typing `<yourExistingTag>/<yourNewTag>`