You can apply the following actions to Tags:
- View Tags
- Filter entities by assigned Tags
- Assign a Tag to multiple items
- Add new Tags
- Rename Tags
- Merge Tags
- Delete Tags
To view all Tags and the entities they are assigned to, create a new Board view with 'Tags' selected as rows.
The List view mode is supported as well:
A number of Filters can be applied to Tags as Lanes. Say, you can exclude first 'No Tags' row with a help of the following lane filter:
?it is not None
Type a text pattern into the filter box to filter out only the Tags that contain that text in the names:
The following examples of Advanced Filters can help you work with Tags:
|Tags||?Generals.Count == 0||Tags that are not used in entities|
|Tags||?Generals.Count > 0||Tags that are used in entities|
|Tags||?Generals.Count == 1||Tags that are used just once|
|Tags||?Generals.Count >= 10||Popular tags that are used 10 times or more|
Assign a Tag to multiple items
On a Board view, select multiple cards (entities) and use the Change Tags action to add a Tag to all these entities.
- Select several cards on a Board view by dragging a rectangle over them with your mouse, or by clicking them one by one with the Ctrl / Cmd key pressed
- Right click on the selected cards and select the Change Tags action in the dropdown menu
- A window showing the already assigned Tags common to all the selected entities will appear
- Input the Tag you'd like to assign to all the selected cards and press the Add button
- Success! Previously assigned tags are preserved and the new Tag is added to all selected entities
If you drag and drop the cards to the lane (row or column) representing a Tag, then Tags previously assigned to the cards are reset and replaced with the newly selected Tag.
Filter entities by assigned Tags
These Advanced Filters are helpful when you set up a view with entities (such as User Stories, Tasks, Bugs, Requests, Features etc.) and the assigned Tags they have.
The filters should be applied to Assignable entities themselves (cards), and not to Tags (lanes).
|Tags.Count == 0||Entities with no Tags assigned|
|Tags.Count > 0||Entities with at least one Tag assigned|
|“plugin” in Tags|
Tags.Where(Name is "plugin")
|Entities with the “plugin” Tag. The Tag should contain this exact single word|
|“plugin” not in Tags|
not Tags.Where(Name is "plugin")
|Negative filter. Entities that don't have“plugin” as their Tag.|
|Tags.Where(Name.Contains("chrome"))||Entities with Tags that include the word “Chrome” as part of their Tag. For example:|
|not Tags.Where(Name.Contains("chrome"))||A negative filter. Entities not having "Chrome" word included into any assigned tag.|
|("chrome" in Name or "chrome" in Description or "chrome" in Tags) and EntityState.IsInitial is True||Example of a complex filter with a combination of several cases|
|Tags.Where(Name is "chrome") and Tags.Where(Name is "urgent")||Entities that have both the "chrome" and "urgent" Tags assigned|
|Tags.Where(Name is "chrome") and not Tags.Where(Name is "urgent")||Entities that have the "chrome" Tag assigned but not the "urgent" Tag|
|Tags.Where(Name is "chrome" or Name is "urgent")||Entities that have either the "chrome" or "urgent" Tags assigned|
You're welcome to learn more about Advanced Filters in our User Guide.
Add new Tags
There are two ways for a new Tag to appear in the system:
- when you edit an entity (such as a User Story, Task, Bug, Feature, Epic etc.) and add a new Tag to it
- when you manually add a Tag using the Tag Management settings page
Tag Management page
To perform actions with Tags, go to Settings → Tags:
This page contains a list of all Tags from all Projects. You can use the search field to filter Tags by name. You can also select Tags by checking the checkbox next to their name. When you select a Tag, a number will be displayed that indicates the number of entities that have this Tag.
You can manually add Tags using the "Add tag" button. To do that, click the"Add tag" button, type in new the new Tag name, and press "Enter".
Tags in Targetprocess are not case-sensitive.
You can rename Tags using the Tag Management page. Select desired Tag by checking the checkbox next to its name. Then click the "Rename tag" button.
Type in new tag name and press "Enter" to save your changes.
You can merge multiple Tags. A common scenario for this operation is when you have multiple Tags that mean the same thing, or perhaps some of them have typos.
To merge Tags, first select them by checking the checkbox next to their names and clicking the "Merge X tags" button.
Then, choose the correct tag name and click the "Merge" button to merge them.
To delete Tags, select them by checking the checkbox next to their names, and then click the "Delete X tags" button.
Sometimes it is not possible to merge or rename Tags. Sometimes, Tags still appear in views even when you have tried to delete them from the Tag Management page. Should this happen, please request assistance from our Support team. We'll let you know how to Delete Tags from the database using REST API requests.