Tags allow you to group issues the way you like, irrelevant of their attributes. For example, you can create a tag *{{fix it today}}* and associate it with issues from different projects, subsystems etc.
You can associate any issue with unlimited number of tags.
{hidden-data}
Similar to the way you search issues by assignee, state, or project, you can assign a tag to any number of issues and search for issues that this tag is associated with. You can view any specific tag as an additional issue attribute that is arbitrary and descriptive.
{hidden-data}
{toc}
h2. Tagging Issues
h3. Adding a tag to issues
*To add a tag with an issue or a set of issues:*
# In the issues list select an issue or several issues you want to set tag for.
# To invoke the [*Command* window|Quick Start Guide. Using Command Window], type *{{tag}}*.
# Specify a name for the tag that you want to associate selected issues with (YouTrack completion will help you with choosing from existing tags).
# Click *Submit* or press *Ctrl+Enter*.
h3. Untagging issues
*To remove a tag from an issue or a set of issues:*
# In the issues list select an issue or several issues you want to remove a tag from.
# To invoke the [*Command* window|YTD3:Contextual Help. Commands], type *{{remove tag}}*.
# Choose the name of a tag that you no longer want to associate with selected issues.
# Click *Submit* or press *Ctrl+Enter*.
{hidden-data}
h3. Viewing issues associated with a certain tag
Obviously, the easiest way to get a list of all issues associated with a tag is to click the tag's name in the list of tags in the side-panel. If you set preliminary filter by a project via Project context drop-down list, then in the result list only issues from the selected project and associated with the selected tag will be shown.
To get a list of all issues marked with a certain tag, click the tag's name in the *Tags* pane of the side-bar on the Issues list.
If you want to narrow the results:
# In the search box, enter *{{tag:}}* and press *Space*.
# Select a tag from the completion list that YouTrack provides.
# Optionally, enter any other search criteria to refine your search. For example, to display unresolved critical issues marked with tag {{fix before end of month}}, enter
{code}
tag: {fix before end of month} state: unresolved priority: critical
{code}
or
{code}
#{fix before end of month} #unresolved #critical
{code}
# Click *Search* or press *Enter*.
{hidden-data}
h2. Sharing Tags
By default, a tag is private, that is: other users do not see your personal tags in the list of accessible tags in the sidebar. However, YouTrack allows you to share a tag with a user group.
You can share a tag with a user group at two levels:
* visibility -- a tag becomes visible for all members of selected group.
* editing -- all members of a selected group can edit tag's parameters or delete the tag.
*To share a tag:*
# Open *Edit tag* dialog by clicking a pencil icon which appears when you hover cursor over a color label next to the tag's name.
# Select user group name in the *Visible for group* list to set a group the tag will be visible to.
# Select user group name in the *Updatable by group* list to set a group the tag will be available for editing.
{hidden-data}
h2. Configuring Tags
h3. Untagging issues as soon as they are resolved
You can set up a tag the way that any issue that it is associated with will be automatically untagged as soon as it is marked as resolved.
# In the *Tags* pane, click the edit icon to the right of a tag.
# In the *Edit tag* dialog box, select *Untag on resolve*.
# Click *Save*.
h3. Configuring tag visibility
You can restrict visibility of a tag to a specific group of YouTrack users.
*To set tag visibility settings:*
# In the *Tags* pane, click the edit icon to the right of a tag.
# Do one or both of the following:
** To let other users search by the tag, select a user group in the *Visible for Group* drop-down list.
** To let other users associate issues with the tag, select a user group in the *Updatable by Group* drop-down list.
# Click *Save*.
h3. Renaming a tag
*To rename an existing tag:*
# In the *Tags* pane, click the edit icon to the right of a tag.
# In the *Edit tag* dialog box, type a new name in the *Name* text box.
# Click *Save*.
{hidden-data}
h2. Deleting a tag
*To delete an existing tag:*
# In the *Tags* pane, click the edit icon next to the tag's name.
# In the *Edit tag* dialog box, click *Delete tag* button.
# Press *OK* to confirm deleting the tag.
You can associate any issue with unlimited number of tags.
{hidden-data}
Similar to the way you search issues by assignee, state, or project, you can assign a tag to any number of issues and search for issues that this tag is associated with. You can view any specific tag as an additional issue attribute that is arbitrary and descriptive.
{hidden-data}
{toc}
h2. Tagging Issues
h3. Adding a tag to issues
*To add a tag with an issue or a set of issues:*
# In the issues list select an issue or several issues you want to set tag for.
# To invoke the [*Command* window|Quick Start Guide. Using Command Window], type *{{tag}}*.
# Specify a name for the tag that you want to associate selected issues with (YouTrack completion will help you with choosing from existing tags).
# Click *Submit* or press *Ctrl+Enter*.
h3. Untagging issues
*To remove a tag from an issue or a set of issues:*
# In the issues list select an issue or several issues you want to remove a tag from.
# To invoke the [*Command* window|YTD3:Contextual Help. Commands], type *{{remove tag}}*.
# Choose the name of a tag that you no longer want to associate with selected issues.
# Click *Submit* or press *Ctrl+Enter*.
{hidden-data}
h3. Viewing issues associated with a certain tag
Obviously, the easiest way to get a list of all issues associated with a tag is to click the tag's name in the list of tags in the side-panel. If you set preliminary filter by a project via Project context drop-down list, then in the result list only issues from the selected project and associated with the selected tag will be shown.
To get a list of all issues marked with a certain tag, click the tag's name in the *Tags* pane of the side-bar on the Issues list.
If you want to narrow the results:
# In the search box, enter *{{tag:}}* and press *Space*.
# Select a tag from the completion list that YouTrack provides.
# Optionally, enter any other search criteria to refine your search. For example, to display unresolved critical issues marked with tag {{fix before end of month}}, enter
{code}
tag: {fix before end of month} state: unresolved priority: critical
{code}
or
{code}
#{fix before end of month} #unresolved #critical
{code}
# Click *Search* or press *Enter*.
{hidden-data}
h2. Sharing Tags
By default, a tag is private, that is: other users do not see your personal tags in the list of accessible tags in the sidebar. However, YouTrack allows you to share a tag with a user group.
You can share a tag with a user group at two levels:
* visibility -- a tag becomes visible for all members of selected group.
* editing -- all members of a selected group can edit tag's parameters or delete the tag.
*To share a tag:*
# Open *Edit tag* dialog by clicking a pencil icon which appears when you hover cursor over a color label next to the tag's name.
# Select user group name in the *Visible for group* list to set a group the tag will be visible to.
# Select user group name in the *Updatable by group* list to set a group the tag will be available for editing.
{hidden-data}
h2. Configuring Tags
h3. Untagging issues as soon as they are resolved
You can set up a tag the way that any issue that it is associated with will be automatically untagged as soon as it is marked as resolved.
# In the *Tags* pane, click the edit icon to the right of a tag.
# In the *Edit tag* dialog box, select *Untag on resolve*.
# Click *Save*.
h3. Configuring tag visibility
You can restrict visibility of a tag to a specific group of YouTrack users.
*To set tag visibility settings:*
# In the *Tags* pane, click the edit icon to the right of a tag.
# Do one or both of the following:
** To let other users search by the tag, select a user group in the *Visible for Group* drop-down list.
** To let other users associate issues with the tag, select a user group in the *Updatable by Group* drop-down list.
# Click *Save*.
h3. Renaming a tag
*To rename an existing tag:*
# In the *Tags* pane, click the edit icon to the right of a tag.
# In the *Edit tag* dialog box, type a new name in the *Name* text box.
# Click *Save*.
{hidden-data}
h2. Deleting a tag
*To delete an existing tag:*
# In the *Tags* pane, click the edit icon next to the tag's name.
# In the *Edit tag* dialog box, click *Delete tag* button.
# Press *OK* to confirm deleting the tag.