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
Creating a Tag group
A maximum of 2 tag groups can be created per landscape on Free plans. For unlimited tag groups, upgrade to Growth or Isolation plans.
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)
Navigate to the bottom Tag bar in a diagram
Click on the
New group
buttonName the Tag group
To edit the Tag group icon, click on the overflow menu and
Set icon
(optional)To re-arrange Tag groups, click and drag on the area to the left of the Tag group (optional)
In the object details view
Click on an object in a diagram or the model objects tab
On the right-hand menu, click the
Add tag
button (if the object already has tags, click on the tag area)Click on
New group
Name the Tag group
Click on the Tag group icon to edit it (optional)
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)
Navigate to the bottom tag bar in a diagram
Click on the Tag group you want to add a tag to
Click on the
New tag
buttonName the tag
Hover on the tag and click on
Color
to edit the tag's colour (optional)
In the object details view
Click on an object in a diagram or the model objects tab
On the right-hand menu, click on the
Add tag
button (if the object already has tags, click on the tag area)Click on the
+
button at the top right of the Tag group or on theNew tag
button if the Tag group is emptyName the tag
Click on the palette icon (🎨) to edit the colour of the tag (optional)
Adding a tag to an object
To add a tag to an object:
Click on an object in a diagram or the Model objects tab
On the right-hand menu, click on the
Add tag
button (if the object already has tags, click on the tag area)Click on the tag(s) you want to add. You can add as many tags to an object
Tip: You can quickly add a tag to multiple objects by multi-selecting objects and applying the tag.
Deleting a Tag group
There are 2 ways to delete a Tag group.
In the bottom tag bar (faster)
Navigate to the bottom tag bar in a diagram
Click on the Tag group you want to delete
Click on the overflow menu beside the Tag group
Click on the
Delete
buttonClick on the
Delete
button again to confirm
In the object details view
Click on an object in a diagram or the model objects tab
On the right-hand menu, click on the tag area
Hover over the Tag group and click on the trash icon (🗑️)
Click on the
Delete
button to confirm
Deleting a tag
There are 2 ways to delete a Tag group:
In the bottom tag bar (faster)
Navigate to the bottom tag bar in a diagram
Click on the Tag group where the tag is located
Hover over the tag you want to delete
Click on the
Delete
buttonClick on the
Delete
button again to confirm
In the object details view
Click on an object in a diagram or the model objects tab
On the right-hand menu, click on the tag area
Hover over a tag and click on the pencil icon (✏️) to the right
Click on the trash icon (🗑️)
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:
Open the Tag bar
Click on the tag you want to pin
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.
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.
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:
Open the Tag bar
Hover on the tag you want to focus on and click the
Focus
buttonTo 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:
Open the Tag bar
Hover on the tag you want to hide and click the
Hide
buttonTo 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.
Note: You can hide more than 1 tag in a diagram
Tags with flows
Using tags in combination with 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:
From your landscape, go to the Model objects tab
Click on the
Filter
buttonClick on
Tags
Select which tags you want to filter
Last updated