Issue Link Types
In YouTrack, you can link issues to show the relationship between them. When you add a link from one issue to another, links are added to both issues.
Issue link types have a property that determines their direction. The direction determines how issues relate to one another. Issue link types can have one of the following link directions:
YouTrack provides the following default issue link types:
As an administrator, you can add other issue link types to YouTrack with different names, however, the behavior of these links is determined by their direction. All link types that use the same direction setting behave similarly. You can view the list of link types that are available in YouTrack on the page.
When you add a link type, you specify the link names and determine whether the link is directed or not.
For directed links, you specify two names:
- An inward name for the source issue. When you add a link to an issue, the link in the source issue is assigned the inward name. For example, when a source issue depends on a target issue.
- An outward name for the target issue. When you add a link to an issue, the link in the target issue is assigned the outward name. For example, when a target issue is required for the source issue.
To create links between issues, users need to have the Link Issues permission on a per-project basis. If users report problems linking issues, ensure that these permissions are configured correctly.
Create an Issue Link Type
You can add your own link types to YouTrack to create and manage dependencies between issues.
To create an issue link type:
- Open the page.
- Click the Create issue link type button.
- Enter values for the following settings:
- Click the Save button.
Edit Link Types
You can modify the settings for existing link types. When you modify these settings, you can also change the behavior of the links that use this link type. Specifically, when you modify the Link Direction setting, links that are already added to issues are modified as follows:
- When you change a directed link type to undirected, only the outward link name remains. Existing links are updated to use the outward name.
- When you change undirected link type to directed, existing link names are updated. The new outward name is assigned to links in target issues. The inward name, if changed, is assigned to links in source issues.
To edit an issue link type:
When changing between directed and undirected types, please note:
Delete Unused Link Types
You can only remove an issue link type if it has no usages in the YouTrack. Even if all links that use this issue link type have been removed from all issues, the link type remains in the issue history and cannot be deleted from YouTrack. For this reason, you can only delete issue link types that have never been added to any issue.