Tag Issues
Last modified: 13 February 2025Tags allow you to group issues the way you like, irrelevant of their attributes. For example, you can create a tag fix it today
and add the tag to issues in multiple projects.
You can associate any issue with an unlimited number of tags.
Tags give you an alternative method to search for issues. Instead of searching by assignee, state, or project, you can tag any number of issues and search for issues by tag. Use tags to add arbitrary and descriptive attributes to any issue without having to worry about adding new custom fields.
The tags you use to categorize issues are also available for use with articles in the knowledge base. This means you can use a single scheme to group and search for content across the application.
Create a Tag
Before you can start working with tags, you need to create them. You can create and use personal tags to categorize issues according to your own tastes or create shared tags to support internal workflows.
By default, tags are visible to you only. Other users cannot see your personal tags.
When you create or edit a tag, use the settings to share the tag with a group. You can share a tag with a group in the following ways:
Make a tag visible to specific users and members of selected groups and project teams. These users can see the tag and use it as a filter to search for issues.
Designate which users can use the tag. Specified users and members of selected groups and teams are able to add the tag to and remove the tag from issues that they also have permission to view and update.
This setting does not affect the visibility of the tag itself. If you want users or group members to be able to use the tag, be sure that they are also allowed to view it.
Let users edit the tag settings. Selected users and members of selected groups and project teams are allowed to update the name, color scheme, and the Remove tag when issue is resolved setting.
The settings that allow other users to view, use, and edit the tag are only available to the tag owner and users who have the Override Visibility Restrictions permission.
This setting does not affect the visibility of the tag itself. If you want users or group members to be able to edit the tag settings, be sure that they are also members of the group that is allowed to view it.
note
The steps for performing this action vary based on whether you add a tag from single issue view or from the issue sidebar. Before you start, make sure you have selected the tab that corresponds with the screen you are currently working with.
To create a tag:
tip
Requires permissions: Create Tag or Saved Search; Share Tag, Saved Search, Agile Board, or Gantt Chart
Open an issue in preview mode or single issue view.
Click the
Add tag icon in the toolbar.
Click the New tag link at the bottom of the list.
The New Tag dialog opens.
Enter values for the following settings:
Setting
Description
Name
Assign the tag a name.
Tag color
Apply an optional color scheme to the tag. Use this setting to make tagged issues stand out in the Issues list.
Remove on resolution
Select to automatically remove the tag from an issue when its state is set to a state that is considered to be resolved.
Shared
Enable this toggle to access advanced sharing settings for the tag.
Owner
tip
Requires additional permissions: Update User; Share Tag, Saved Search, Agile Board, or Gantt Chart
Stores the name of the user who is assumed to be responsible for managing the tag and its permissions. This can be set to any user in the system.
Can view
Select which users can see the tag and use it as a filter to search for issues. You can select multiple users, groups, and project teams.
Can use
Select which users are allowed to add the tag to and remove the tag from the issues that they also have permission to view and update. You can select multiple users, groups, and project teams.
This setting does not affect the visibility of the tag itself. If you want users or group members to be able to use the tag, be sure that they are also allowed to view it.
Can edit
Select which users can update the settings for this tag. You can select multiple users, groups, and project teams.
This setting does not affect the visibility of the tag itself. If you want users or group members to be able to edit the tag settings, be sure that they are also allowed to view it.
Mark as favorite for all viewers
tip
Requires additional permissions: Update User; Share Tag, Saved Search, Agile Board, or Gantt Chart
Enable to mark this tag as favorite for all users who can view the tag.
Subscriptions
Displays settings that let you subscribe to specific update events for issues, tickets, and articles that are marked using this tag. These settings are only relevant to your YouTrack account and are not transferred to other users who can view or use the tag.
For more information about available subscription options, see Subscriptions.
Click the Create button.
To create a tag:
tip
Requires permissions: Create Tag or Saved Search; Share Tag, Saved Search, Agile Board, or Gantt Chart
Navigate to the Issues list and expand the sidebar.
Expand the menu to show the list of available tags in the Tags section of the sidebar.
Click the
New tag button at the top of the Tags list.
The New Tag dialog opens.
Enter values for the following settings:
Setting
Description
Name
Assign the tag a name.
Click the
star icon next to the name field to mark this tag as a favorite.
Tag color
Apply an optional color scheme to the tag. Use this setting to make tagged issues stand out in the Issues list.
Owner
tip
Requires additional permissions: Update User; Share Tag, Saved Search, Agile Board, or Gantt Chart
Stores the name of the user who is assumed to be responsible for managing the tag and its permissions. This can be set to any user in the system.
Can view
Select which users can see the tag and use it as a filter to search for issues. You can select multiple users, groups, and project teams.
Can use
Select which users are allowed to add the tag to and remove the tag from the issues that they also have permission to view and update. You can select multiple users, groups, and project teams.
This setting does not affect the visibility of the tag itself. If you want users or group members to be able to use the tag, be sure that they are also allowed to view it.
Can edit
Select which users can update the settings for this tag. You can select multiple users, groups, and project teams.
This setting does not affect the visibility of the tag itself. If you want users or group members to be able to edit the tag settings, be sure that they are also allowed to view it.
Remove on resolution
Enable to automatically remove the tag when the issue is set to a resolved state.
Mark as favorite for all viewers
tip
Requires additional permissions: Update User; Share Tag, Saved Search, Agile Board, or Gantt Chart
Enable to mark this tag as favorite for all users who can view the tag.
Optionally, expand the Subscriptions section. If you want to receive notifications for specific events, you can enable them here before the tag is created.
Click the Save button.
note
You can also create tags directly in your YouTrack profile. For instructions, see New Tags and Saved Searches.
Add Tags to Issues
You can add tags to issues one at a time or search for issues that match specific criteria and tag them all at once. These actions are available to:
The user who created the tag (its owner).
Users and members of groups or teams who are allowed to use the tag.
To add a tag to one or more issues:
tip
Requires permissions: Read Issue
Select one or more issues in the Issues list.
Click the
Add tag button in the issue toolbar.
Select the tag that you want to add to the selected issues. To help find the tag you want, filter the list by name. YouTrack filters the list of tags as you type.
Select the tag from the list.
The tag is added to all the selected issues.
You can also add tags to issues in the Apply Command dialog. This command uses the syntax add tag <tag name>

Remove Tags from Issues
Tags are like sticky notes. You can slap them on something to keep track of it for now, but you can easily remove them later when they're no longer needed.
We use tags like design, wording, and documentation to indicate that an issue requires input from a specific department without assigning the issue explicitly to a member of the team. When the team has provided the required input or feedback, they remove the tag.
This action is available to:
The user who created the tag (its owner).
Users and members of groups or teams who are allowed to use the tag.
The Edit Tag or Saved Search permission is not required. This permission only determines whether users who are members of the group that is allowed to edit a tag can update its properties.
To remove a tag from one or more issues:
tip
Requires permissions: Read Issue, Update Issue
Open the issue list.
Click the
Remove icon for the tag that you want to remove from the issue.
You can also remove tags to multiple issues at once in the Apply Command dialog. This command uses the syntax remove tag <tag name>

Add and Remove Tags Automatically
Adding and removing tags manually requires minimal effort, but if you want to incorporate tags into your business processes, you might want to automate these actions.
YouTrack workflows let you add and remove tags automatically whenever a specific set of conditions is met. This means you can use tags to initiate a set of actions or filter for issues that have been processed by the workflow.
To learn how to work with tags using the no-code workflow constructor, see Add a Tag and Remove a Tag.
To see a sample workflow that removes a tag automatically based on a change in the issue state, see Untag on Reopen.
View a List of Tagged Issues
The easiest way to list the issues that are associated with a tag is to click the corresponding tag in any issue. This automatically switches to the list view and filters the list to show issues with this tag.
You can also filter the Issues list by selecting a tag in the Tags section of the sidebar.
If you set a preliminary filter as a search context, the list displays issues that match the selected context and are associated with the selected tag.
You can also use a tag itself as a search context. This action is available to:
The user who created the tag (its owner).
Users and members of groups or teams who are allowed to view the tag.
To search for issues by tag:
tip
Requires permissions: Read Issue
Click the Issues link in the application header.
Enter
tag:
in the search box.Select a tag from the completion list.
Enter additional search criteria to refine your search. For example, to display unresolved critical issues that are tagged with fix by end of month, enter:
tag: {fix by end of month} state: unresolved priority: critical
or
#{fix by end of month} #unresolved #critical
Click the
Search button or press Enter.
Tags are also available in filter mode using the syntax Tag
is | is not
<tag name>
.

Edit Tag Settings
Your ability to edit tag settings varies based on the type of tag.
For tags that you created yourself, you can update any of the tag settings at any time.
For tags that are shared with you, you can only change the name, color scheme, and the Remove on resolution setting.
These actions are available to:
The user who created the tag (its owner).
Users and members of groups or teams who are allowed to edit the tag.
The following settings are available:
Setting | Description |
---|---|
Name | Stores the name of the tag. |
Owner |
Stores the name of the user who is assumed to be responsible for managing the tag and its permissions. This can be set to any user in the system. For new tags, the owner defaults to the current user. When a new tag is added to the system by a workflow, its owner is set to the YouTrack Workflow user account. |
Can view | Determines which users and groups can see the tag when it has been applied to the issue. This also gives users the ability to use the tag to filter for issues in various contexts. |
Can use | Determines which users and groups can apply and remove the tag in the issues that they have permission to update. |
Can edit | Determines which users and groups can edit the settings for the tag. |
Remove on resolution | Determines whether the tag is automatically removed from issues when they transition to a state that is considered to be resolved. Moving the issue back to an unresolved state doesn't restore the tag. |
Mark as favorite for all viewers |
Determines whether the tag is automatically marked as favorite for all users who can view the tag. |
To edit tag settings:
tip
Requires permissions: Edit Tag or Saved Search
From the issue sidebar, click to expand the
Options menu next to the tag, then select the
Edit tag option.
The Edit Tag dialog opens.
Update the settings that you want to modify.
note
Old Permission SchemeShared tags that were created before the YouTrack 2020.4 release use an old permission scheme. This scheme requires that users are either allowed to edit the tag or have permission to update private fields in the project in order to use it.
If you want to let specific users and members of groups use this tag, select one or more users and groups from the list. The old permission scheme will no longer determine who can use the tag.
Click the Apply changes button.
note
You can also update tags directly in your YouTrack profile. For instructions, see Managing Tags and Saved Searches.
Delete a Tag
The user who created a tag is able to delete the tag from YouTrack. Users with the Override Visibility Restrictions permission are able to view and manage tags that were created by other users. Other users only have the option to hide the tag by unpinning it from the sidebar.
If you have a personal tag that you no longer want to use or have shared a tag that is obsolete, you can delete it from the system.
note
Star TagThe Star tag is automatically generated for your account when you star an issue or mark a favorite article. Once this tag has been generated for you, you cannot delete it from the system.
To delete a tag:
tip
Requires permissions: Edit Tag or Saved Search, Delete Tag or Saved Search
From the issue sidebar, click to expand the
Options menu next to the tag, then select the
Edit tag option.
The Edit Tag dialog opens.
In the Edit Tag dialog, click Delete tag button.
Click OK to confirm the action.
The tag is deleted. The tag is removed from all issues.
If you don't see the option to edit or delete a tag, it means the owner of the tag hasn't given you permission to edit it. To find the owner of a tag, check the Tags and Saved Searches tab in your YouTrack profile. For more information, see Tags and Saved Searches.
Thanks for your feedback!