# Tags Tags are flexible model object properties that help organize and draw attention to different objects in your system. They're fully customizable, and with IcePanel's tag visualization tools, you can show different perspectives on your system to have more focused discussions. With tags, you can highlight specific parts of your system like: * Risk * Cost * Security * Regions * Release versions * Deployment information

Add tags and visualize your system from multiple perspectives

## Creating a Tag group {% hint style="info" %} A maximum of 2 tag groups can be created per landscape on Free plans. For unlimited tag groups, upgrade to Growth or Isolation plans. {% endhint %} A Tag group is a collection or category for your tags. Tag groups and their respective tags are shared across a landscape and can be edited by users with `Editor` or `Admin` permissions. There 2 ways to create a Tag group: ### **In the bottom Tag bar (faster)** 1. Navigate to the bottom Tag bar in a diagram 2. Click on the `New group` button 3. Name the Tag group 4. To edit the Tag group icon, click on the overflow menu and `Set icon` *(optional)* 5. To re-arrange Tag groups, click and drag on the area to the left of the Tag group *(optional)*

### **In the object details view** 1. Click on an object in a diagram or the model objects tab 2. On the right-hand menu, click the `Add tag` button (if the object already has tags, click on the tag area) 3. Click on `New group` 4. Name the Tag group 5. Click on the Tag group icon to edit it (*optional)*

Creating a new Tag group in object details view

## Creating a tag There are no restrictions on the number of tags you can create on all plans, but they must be nested in a Tag group. There are 2 ways to create a tag: ### **In the bottom Tag bar (faster)** 1. Navigate to the bottom tag bar in a diagram 2. Click on the Tag group you want to add a tag to 3. Click on the `New tag` button 4. Name the tag 5. Hover on the tag and click on `Color` to edit the tag's colour *(optional)*

### **In the object details view** 1. Click on an object in a diagram or the model objects tab 2. On the right-hand menu, click on the `Add tag` button (if the object already has tags, click on the tag area) 3. Click on the `+` button at the top right of the Tag group or on the `New tag` button if the Tag group is empty 4. Name the tag 5. Click on the palette icon (🎨) to edit the colour of the tag *(optional)*

Creating a new tag in object details view

## Adding a tag to an object To add a tag to an object: 1. Click on an object in a diagram or the Model objects tab 2. On the right-hand menu, click on the `Add tag` button (if the object already has tags, click on the tag area) 3. Click on the tag(s) you want to add. You can add as many tags to an object {% hint style="info" %} **Tip:** You can quickly add a tag to multiple objects by multi-selecting objects and applying the tag. {% endhint %}

## Deleting a Tag group There are 2 ways to delete a Tag group. ### **In the bottom tag bar (faster)** 1. Navigate to the bottom tag bar in a diagram 2. Click on the Tag group you want to delete 3. Click on the overflow menu beside the Tag group 4. Click on the `Delete` button 5. Click on the `Delete` button again to confirm

### **In the object details view** 1. Click on an object in a diagram or the model objects tab 2. On the right-hand menu, click on the tag area 3. Hover over the Tag group and click on the trash icon (🗑️) 4. Click on the `Delete` button to confirm

Deleting a Tag group in object details view

## Deleting a tag There are 2 ways to delete a Tag group: ### **In the bottom tag bar (faster)** 1. Navigate to the bottom tag bar in a diagram 2. Click on the Tag group where the tag is located 3. Hover over the tag you want to delete 4. Click on the `Delete` button 5. Click on the `Delete` button again to confirm

### **In the object details view** 1. Click on an object in a diagram or the model objects tab 2. On the right-hand menu, click on the tag area 3. Hover over a tag and click on the pencil icon (✏️) to the right 4. Click on the trash icon (🗑️) 5. Click on the `Delete` button to confirm

## Seeing tags in a diagram You can view your tags in a diagram by opening the Tags bar at the bottom of the navigation. Click on the `Tags` label or a Tag group to open it. Tags are only visible in a diagram when the Tags bar is open. The Tags bar is a controller for: * Showing tags by Tag group in a diagram * Highlighting objects by tag by hovering over it * Pinning objects by clicking on the tag * Focusing on objects by tag * Hiding objects by tag ### Showing tags by Tag group When the Tag bar opens, you can switch between Tag groups to view your diagram objects with their respective tags. Each object will display the tag's colour as a coloured bar on the bottom. If an object has 2 or more tags applied, it will add a bar for each tag colour horizontally responsive. Connections only use the colour of the first tag applied unless hovering, pinning, or focusing on other tags.

### Highlighting objects by tag Hovering on a tag will highlight all objects in that tag's colour in the diagram.

### Pinning a tag Pinning tags is a quick way to give extra visual attention to specific objects in the diagram. To pin a tag: 1. Open the Tag bar 2. Click on the tag you want to pin 3. Click on the tag again to unpin it Pinned tags apply a dotted line in the colour of the tag around the object. The tag name is also added to the bottom left of the object.

{% hint style="info" %} **Tip:** You can click on the pin icon (📍) to pin all tags in a Tag group. If an object has more than 1 tag, the dotted line will default to the *first* tag in the list. {% endhint %} ### Focusing on a tag Focusing on a tag allows you to reduce the complexity of a diagram by only showing the objects with the tag, their connections (any direction), and the objects they're connected to. To focus on a tag: 1. Open the Tag bar 2. Hover on the tag you want to focus on and click the `Focus` button 3. To unfocus the tag, click on the tag again Only objects with that tag, their connections, and connected objects will appear in the diagram. Connected objects will be slightly greyed out. An indicator will appear in the bottom navigation to show tags in focus. You can also use this to unfocus the tag.

### Hiding a tag Hiding a tag removes all objects with the tag and their connections (any direction) in the diagram. It's a great way to show the difference when model objects are being deprecated or exist in a future release without removing them permanently from the diagram or model. To hide a tag: 1. Open the Tag bar 2. Hover on the tag you want to hide and click the `Hide` button 3. To unhide the tag, click on the tag again Objects with that tag and their connections will disappear from the diagram unless you hover over the tag (they'll appear slightly greyed out). An indicator will appear in the bottom navigation to show hidden tags.

{% hint style="info" %} **Note:** You can hide more than 1 tag in a diagram {% endhint %} ## Tags with flows Using tags in combination with [Flows](https://docs.icepanel.io/visual-storytelling/flows) is a great way to visualize use cases with an added layer of perspective. This can help your team identify anything from risky areas in a flow to expensive systems or apps that should be investigated for cost reduction.

## Filtering tags in the Model objects tab If you prefer to view objects by tag in a list view, you can use filters in the Model objects tab. Here's how to do this: 1. From your landscape, go to the Model objects tab 2. Click on the `Filter` button 3. Click on `Tags` 4. Select which tags you want to filter