YouTrack Standalone 2020.6 Help

Tag Issues

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 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.

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 Untag on resolve 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.

To create a tag:

  1. Navigate to the Issues list and expand the sidebar.

  2. Expand the menu to show the list of available tags in the Tags section of the sidebar.

  3. Click the New tag link at the bottom of the list.

    Option to add tag from the sidebar in the Issues list.
    • The New Tag dialog opens.

      The New Tag dialog

  4. 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.

    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 tag when issue is resolved

    Enable to automatically remove the tag when the issue is set to a resolved state.

  5. Optionally, expand the Subscriptions section. If you want to receive notification for specific events, you can enable them here before the tag is created.

  6. Click the Save button.

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:

  1. Select one or more issues in the Issues list.

  2. Click the Add tag button in the toolbar.

  3. 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.

    Add a tag to multiple issues with an option from the toolbar.

  4. Select the tag from the list.

    • The tag is added to all of the selected issues.

  5. Click Submit or press Ctrl + Enter.

You can also add tags to issues in the Apply Command dialog. This command uses the syntax add tag <tag name>

Add a tag to multiple issues with a command.

Remove Tags from Issues

Tags are like temporary tattoos. You can apply them to look cool at the nightclub and wash them off in the morning.

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:

  1. Select one or more issues in the Issues list.

  2. Open the Apply Command dialog.

  3. Enter the command remove tag.

  4. Select the tag that you want to remove from the completion list (or continue typing the name of the tag).

  5. Click the Apply button, or press Ctrl + Enter.

View Issues Associated with a Tag

The easiest way to list the issues that are associated with a tag is to click the name of the tag in 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.

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:

  1. Enter tag: in the search box.

  2. Select a tag from the completion list.

  3. Enter additional search criteria to refine your search. For example, to display unresolved critical issues that are tagged with fix before end of month, enter:

    tag: {fix before end of month} state: unresolved priority: critical

    or

    #{fix before end of month} #unresolved #critical
  4. Click the Search button or press Enter.

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 Untag on resolve 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.

To edit tag settings:

  1. Click the Edit icon next to the tag in the sidebar.

    Edit tag option in the sidebar on the Issues list.
    • The Edit Tag dialog opens.

    Edit Tag dialog
  2. Update the settings that you want to modify. The visibility settings are only shown to the user who created the tag.

  3. Click the Save button.

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.

To delete a tag:

  1. Click the Edit icon next to the tag in the sidebar.

  2. In the Edit Tag dialog, click Delete tag button.

  3. Click OK to confirm the action.

    • The tag is deleted. The tag is removed from all issues.

Last modified: 30 March 2021