Skip to content

link-type-reference.md

Latest commit

 

History

History
946 lines (830 loc) · 36.7 KB

link-type-reference.md

File metadata and controls

946 lines (830 loc) · 36.7 KB
title Link Types Reference Guide
titleSuffix Azure Boards
description Use this reference guide to understand all the link types defined for Azure DevOps and Azure Boards.
ms.service azure-devops-boards
ms.custom work-items, cross-project, cross-service, engagement-fy23
ms.assetid 219717a0-de6e-4f70-8558-54f813f82507
ms.author chcomley
author chcomley
ms.topic reference
monikerRange <= azure-devops
ms.date 10/08/2025
ai-usage ai-assisted

Reference guide for link types

[!INCLUDE version-lt-eq-azure-devops]

Use different link types to manage relationships between work items and other artifacts, such as builds, commits, and pull requests. This article describes the following link types.

::: moniker range="azure-devops"

  • Work link type: Links work items including select test case management work items
  • Hyperlink: Connects a work item to any URL or network share
  • External link type: Connects a work item to an external object, such as a code object, build, or wiki page
  • Remote work link type: Connects work items that are defined in different organizations
  • GitHub link type: Connects a work item to a GitHub repository commit, issue, or pull request.

A specific field maintains a count of links for the first four link types, such as Related Link Count, Hyperlink Count, External Link Count, and Remote Link Count.

::: moniker-end

::: moniker range="<azure-devops"

  • Work link type: links work items including select test case management work items
  • Hyperlink: connects a work item to any URL or network share
  • External link type: connects a work item to an external object, such as a code object, build, or wiki page
  • GitHub link type: connects a work item to a GitHub repository commit or pull request.

A specific field maintains a count of links for the first three link types, such as Related Link Count, Hyperlink Count, and External Link Count.

::: moniker-end

Link types have topological restrictions. Use the guidance in the following tables to choose a link type based on the queries and reports you plan to create. To learn more about topologies, see Link type topologies and restrictions.

Work link type

Work link types are system-defined, process-defined, or user-defined (custom). The links listed in the following table are system-defined.

Each work link type defines labels, topology, and restrictions used when you construct links between work items. For example, the parent-child link type defines two labels: Parent and Child. The link type uses a tree topology and prevents circular references between work items.

:::image type="content" source="media/link-type-reference/linkscontrol-work-item-link-types.png" alt-text="Screenshot that shows a conceptual diagram of a work item link type.":::

A work item's Related Link Count equals the sum of all links defined with a work link type.

::: moniker range="< azure-devops"

The following table describes the work item link types you can specify to scope a links control using the WorkItemLinksFilter XML element.

::: moniker-end

:::row::: :::column span="1"::: Name :::column-end::: :::column span="3"::: Reference name :::column-end::: :::column span="3"::: Usage :::column-end::: :::row-end:::

:::row::: :::column span="1"::: Affects-Affected by (CMMI only) :::image type="content" source="media/link-work-items-support-traceability/affects-cmmi.png" alt-text="Screenshot that shows a conceptual diagram of the Affects link type."::: :::image type="content" source="media/link-work-items-support-traceability/affected-by-cmmi.png" alt-text="Screenshot that shows a conceptual diagram of the Affected by link type."::: :::column-end::: :::column span="3"::: Microsoft.VSTS.Common.Affects-Forward
Microsoft.VSTS.Common.Affects-Reverse
Topology type: Dependency
Link category: Process-defined
:::column-end::: :::column span="3":::

Use this directional link to create links between work items without creating closed loops. People typically use it to track change requests linked to requirements.

Restrictions and recommendations:

  • Link a change request to only one requirement using Affects. Link requirements to as many child change requests as needed using Affected by.
  • Only use Affects-Affected by links to link work items in the same project. We recommend this when you plan to use Excel to modify or update work item data.

:::column-end::: :::row-end::: :::row::: :::column span="1"::: Child-Parent
:::image type="content" source="media/link-work-items-support-traceability/child-tree-forward.png" alt-text="Screenshot that shows a conceptual diagram of the Child link type.":::
:::image type="content" source="media/link-work-items-support-traceability/parent-tree-reverse.png" alt-text="Screenshot that shows a conceptual diagram of the Parent link type."::: :::column-end::: :::column span="3"::: System.LinkTypes.Hierarchy-Forward
System.LinkTypes.Hierarchy-Reverse
Topology type: Tree
Link category: System-defined
:::column-end::: :::column span="3":::

Use this directional link to create one-to-many relationships between a single parent and one or more child items. Use it to organize work items within a hierarchy. You can create this hierarchy among backlog items using the mapping function or among backlog items and tasks using the sprint backlog or Taskboard.

Typical uses include:

  • Maintain task-summary relationships. Parent-child links represent summary tasks and their subordinate tasks.
  • Link tasks to PBIs, user stories, or requirements. Supports Backlog Overview, Stories Overview, and Requirements Overview reports.

Restrictions and recommendations:

  • Use Excel to bulk edit both work items and parent-child links. See Bulk add or modify work items with Excel.
  • A work item can have only one Parent. A parent work item can have many children.
  • Only use parent-child links to link work items in the same project. We recommend this when you plan to use Excel to modify or update work item data.

:::column-end::: :::row-end::: :::row::: :::column span="1"::: Duplicate-Duplicate of :::image type="content" source="media/link-work-items-support-traceability/duplicate-tree-forward.png" alt-text="Screenshot that shows a conceptual diagram of the Duplicate link type."::: :::image type="content" source="media/link-work-items-support-traceability/duplicate-of-tree-reverse.png" alt-text="Screenshot that shows a conceptual diagram of the Duplicate Of link type."::: :::column-end::: :::column span="3"::: System.LinkTypes.Duplicate-Forward
System.LinkTypes.Duplicate-Reverse
Topology type: Tree
Link category: System-defined
:::column-end::: :::column span="3":::

Use this directional link to create one-to-many relationships to track tasks, bugs, or other work items that duplicate one another.

Restrictions and recommendations:

  • A work item can have only one Duplicate.
  • Only use Duplicate or Duplicate Of links to link work items in the same project. We recommend this when you plan to use Excel to modify or update work item data.

:::column-end::: :::row-end::: :::row::: :::column span="1"::: Referenced By-References
:::image type="content" source="media/link-work-items-support-traceability/tested-by-dependency-forward.png" alt-text="Screenshot that shows a conceptual diagram of the Referenced By link type."::: :::image type="content" source="media/link-work-items-support-traceability/tests-dependency-reverse.png" alt-text="Screenshot that shows a conceptual diagram of the References link type."::: :::column-end::: :::column span="3"::: Microsoft.VSTS.TestCase.
SharedParameterReferencedBy
Topology type: Dependency
Link category: Process-defined
:::column-end::: :::column span="3":::

Use this to link test cases to shared parameters and to support repeating a test with different data. Generally, you don't add this link type to a scoped links control. :::column-end:::

:::row-end::: :::row::: :::column span="1"::: Related
:::image type="content" source="media/link-work-items-support-traceability/related-network.png" alt-text="Screenshot that shows a conceptual diagram of the Related link type."::: :::column-end::: :::column span="3"::: System.LinkTypes.Related
Topology type: Network
Link category: System-defined
:::column-end::: :::column span="3"::: Use this nondirectional link to create relationships between work items. Use it to link work items at the same level (for example, two user stories that overlap). The Related link type creates simple relationships with few restrictions.

  • Relate work items that are at the same level.
  • Link work items defined in different projects and managed by different teams.
  • Find and view work items and their related work items in a two-tiered view.
  • Create simple relationships with few restrictions.

:::column-end::: :::row-end::: :::row::: :::column span="1"::: Successor-Predecessor
:::image type="content" source="media/link-work-items-support-traceability/successor-dependency-forward.png" alt-text="Screenshot that shows a conceptual diagram of the Successor dependency."::: :::image type="content" source="media/link-work-items-support-traceability/predecessor-dependency-reverse.png" alt-text="Screenshot that shows a conceptual diagram of the Predecessor dependency."::: :::column-end::: :::column span="3"::: System.LinkTypes.Dependency
Topology type: Dependency
Link category: System-defined
Choose Predecessor when linking to a work item that should complete before the current item. Choose Successor when linking to a work item that should complete after the current item.

:::column-end::: :::column span="3"::: Use this directional link to track tasks that must finish before others start. Linked tasks appear as predecessor-successor links in Azure Boards.

  • Track tasks that must be completed before others can begin.
  • Support one-to-many relationships.
  • Find predecessor and successor work items in a two-tiered direct-links query view.

Restrictions and recommendations:

  • An error appears when you attempt to create circular relationships.
  • Create predecessor-successor links only for work items within the same project when you plan to export to Excel. You can create predecessor-successor links across projects, but Excel export/import will only include items for the project that defines the query.

:::column-end::: :::row-end::: :::row::: :::column span="1"::: Tested by-Tests
:::image type="content" source="media/link-work-items-support-traceability/tested-by-dependency-forward.png" alt-text="Screenshot that shows a conceptual diagram of the Tested by link type."::: :::image type="content" source="media/link-work-items-support-traceability/tests-dependency-reverse.png" alt-text="Screenshot that shows a conceptual diagram of the Tests link type."::: :::column-end::: :::column span="3"::: Microsoft.VSTS.Common.TestedBy-Forward
Microsoft.VSTS.Common.TestedBy-Reverse
Topology type: Dependency
Link category: Process-defined
:::column-end::: :::column span="3":::

Link test cases to work items such as bugs, user stories, requirements, and PBIs. Use this to track test cases that validate user stories (Agile), PBIs (Scrum), or requirements (CMMI). For on-premises Azure DevOps, several SQL reports depend on these links. See Review team activities to support useful reports.

:::column-end::: :::row-end::: :::row::: :::column span="1"::: Test Case-Shared Steps
:::image type="content" source="media/link-work-items-support-traceability/tested-by-dependency-forward.png" alt-text="Screenshot that shows a conceptual diagram of Test Case to Shared Steps link."::: :::image type="content" source="media/link-work-items-support-traceability/tests-dependency-reverse.png" alt-text="Screenshot that shows a conceptual diagram of Shared Steps to Test Case link."::: :::column-end::: :::column span="3"::: Microsoft.VSTS.TestCase.
SharedStepReferencedBy
Topology type: Dependency
Link category: Process-defined
:::column-end::: :::column span="3":::

Use this to link test cases with shared steps. Share steps between test cases to avoid duplicating the same sequence of steps.

:::column-end::: :::row-end:::

Hyperlink

A hyperlink links a work item to any URL. The Hyperlink Count tracks the number of hyperlinks on a work item.

:::image type="content" source="media/link-type-reference/hyperlink.png" alt-text="Screenshot that shows a conceptual diagram of a Hyperlink.":::

:::row::: :::column span="1"::: Link name :::column-end::: :::column span="1"::: Tool supported :::column-end::: :::column span="1"::: Artifact type :::column-end::: :::column span="1"::: Usage :::column-end::: :::row-end:::

:::row::: :::column span="1"::: Hyperlink :::column-end::: :::column span="1"::: Work item tracking :::column-end::: :::column span="1"::: Hyperlink :::column-end::: :::column span="1"::: Use this to link a work item to a URL. Work item Hyperlink is the name of this link type in the Artifact Link Types API. :::column-end::: :::row-end:::

External link type

External link types are system-defined and link work items to other objects stored within Azure DevOps. A work item's External Link Count equals the sum of all links defined with external link types.

[!div class="mx-imgBorder"]
:::image type="content" source="media/link-type-reference/linkscontrol-external-link-types.png" alt-text="Screenshot that shows a conceptual diagram of external link types.":::

Note

Use an external link type only to link to an Azure DevOps object. To link work items to objects outside Azure DevOps, use a hyperlink.

::: moniker range="azure-devops"
The following table describes the external link types you can choose when you add a link from a work item or test case. ::: moniker-end

::: moniker range="< azure-devops"
The following table describes the external link types you can choose when adding a link from a work item or test case. You can also specify one of these link types to scope a links control using the ExternalLinksFilter XML element. ::: moniker-end

:::row::: :::column span=""::: Link name :::column-end::: :::column span=""::: Tool supported :::column-end::: :::column span=""::: Artifact type :::column-end::: :::column span=""::: Usage :::column-end::: :::row-end:::

:::row::: :::column span=""::: Security Alert :::column-end::: :::column span=""::: Advanced Security :::column-end::: :::column span=""::: Advanced Security :::column-end::: :::column span=""::: Used to link a work item to an Advanced Security alert. :::column-end::: :::row-end::: :::row::: :::column span=""::: Branch :::column-end::: :::column span=""::: Git :::column-end::: :::column span=""::: Branch :::column-end::: :::column span=""::: Use to link a work item to a branch. :::column-end::: :::row-end::: :::row::: :::column span=""::: Pipelines/Build :::column-end::: :::column span=""::: Build :::column-end::: :::column span=""::: Build :::column-end::: :::column span=""::: Use to link a work item to a build. :::column-end::: :::row-end::: :::row::: :::column span=""::: Changeset (or Fixed in Changeset) :::column-end::: :::column span=""::: VersionControl :::column-end::: :::column span=""::: Changeset :::column-end::: :::column span=""::: Use to link a work item to a changeset. :::column-end::: :::row-end::: :::row::: :::column span=""::: Commit (or Fixed in Commit) :::column-end::: :::column span=""::: Git :::column-end::: :::column span=""::: Commit :::column-end::: :::column span=""::: Use to link a work item to a commit. :::column-end::: :::row-end::: :::row::: :::column span=""::: Found in build :::column-end::: :::column span=""::: Pipelines/Build :::column-end::: :::column span=""::: Build :::column-end::: :::column span=""::: Use to link a work item to a build. :::column-end::: :::row-end::: :::row::: :::column span=""::: Integrated in build :::column-end::: :::column span=""::: Build :::column-end::: :::column span=""::: Build pipeline :::column-end::: :::column span=""::: Use to link a work item to a build. :::column-end::: :::row-end::: :::row::: :::column span=""::: Integrated in release environment :::column-end::: :::column span=""::: Release :::column-end::: :::column span=""::: Release pipeline :::column-end::: :::column span=""::: Use to link a release to a work item. The system creates this type when a user enables Report deployment status to Work for a release definition. :::column-end::: :::row-end::: :::row::: :::column span=""::: Pull Request :::column-end::: :::column span=""::: Git :::column-end::: :::column span=""::: PullRequestId :::column-end::: :::column span=""::: Use to link a work item to a pull request. :::column-end::: :::row-end::: :::row::: :::column span=""::: Result attachment
:::column-end::: :::column span=""::: Test Management :::column-end::: :::column span=""::: TcmResultAttachment :::column-end::: :::column span=""::: Use to link a work item to an attachment associated with a test result. These links appear when you associate a work item with a test result from Test or Microsoft Test Manager. :::column-end::: :::row-end::: :::row::: :::column span=""::: Source Code File :::column-end::: :::column span=""::: VersionControl :::column-end::: :::column span=""::: LatestItemVersion :::column-end::: :::column span=""::: Use to link a work item to a file under Team Foundation version control (TFVC).
:::column-end::: :::row-end::: :::row::: :::column span=""::: Storyboard :::column-end::: :::column span=""::: Requirements :::column-end::: :::column span=""::: Storyboard :::column-end::: :::column span=""::: Use to link a work item to a PowerPoint file or other file that contains storyboarding information on a network. :::column-end::: :::row-end::: :::row::: :::column span=""::: Tag :::column-end::: :::column span=""::: Git :::column-end::: :::column span=""::: Tag :::column-end::: :::column span=""::: Use to link a work item to a tag defined for a git commit or repository. For more, see Work from the Git command prompt. :::column-end::: :::row-end::: :::row::: :::column span=""::: Test Result :::column-end::: :::column span=""::: Test Management :::column-end::: :::column span=""::: TcmResult :::column-end::: :::column span=""::: Use to link a work item to a test result. These links appear when you associate a work item with a test result from Test or Microsoft Test Manager.
:::column-end::: :::row-end::: :::row::: :::column span=""::: Versioned item :::column-end::: :::column span=""::: VersionControl :::column-end::: :::column span=""::: LatestItemVersion :::column-end::: :::column span=""::: Use to link a work item to a file or changeset defined within a TFVC repository. Source Code File is the name of this link type in the Artifact Link Types API.
:::column-end::: :::row-end::: :::row::: :::column span=""::: Wiki :::column-end::: :::column span=""::: Wiki :::column-end::: :::column span=""::: Wiki :::column-end::: :::column span=""::: Use to link a work item to a wiki page. Supported for TFS 2018.2 and later versions. :::column-end::: :::row-end:::

::: moniker range="<=azure-devops"

GitHub link type

GitHub link types are system-defined and link work items to GitHub objects as shown here.

::: moniker-end

::: moniker range="<=azure-devops"

:::image type="content" source="media/link-type-reference/linkscontrol-github-link-types.png" alt-text="Screenshot that shows a conceptual diagram of GitHub link types.":::

::: moniker-end

::: moniker range="<=azure-devops"

Important

You can only link to GitHub artifacts for repositories connected to Azure Boards.

The following table describes the GitHub link types you can choose when adding a link from a work item.

:::row::: :::column span="1"::: Link name :::column-end::: :::column span="1"::: Artifact type :::column-end::: :::column span="2"::: Usage :::column-end::: :::row-end:::

:::row::: :::column span="1"::: GitHub Commit :::column-end::: :::column span="1"::: GitHub repository commit :::column-end::: :::column span="2"::: Use to link a work item to a GitHub commit. :::column-end::: :::row-end::: ::: moniker-end ::: moniker range="<=azure-devops" :::row::: :::column span="1"::: GitHub Issue :::column-end::: :::column span="1"::: GitHub repository issue :::column-end::: :::column span="2"::: Use to link a work item to a GitHub issue. :::column-end::: :::row-end::: ::: moniker-end ::: moniker range="<=azure-devops" :::row::: :::column span="1"::: GitHub Pull Request :::column-end::: :::column span="1"::: GitHub repository pull request :::column-end::: :::column span="2"::: Use to link a work item to a GitHub pull request. :::column-end::: :::row-end:::

::: moniker-end

::: moniker range="azure-devops"

Remote work link type

Remote work link types support linking work items defined in different organizations, as long as the same Microsoft Entra ID manages those organizations (see Connect your organization to Microsoft Entra ID).

A work item's Remote Link Count equals the sum of all links defined with a remote work link type.

:::row::: :::column span=""::: Name :::column-end::: :::column span=""::: Reference name :::column-end::: :::column span=""::: Usage :::column-end::: :::row-end:::

:::row::: :::column span=""::: Consumes From-Produced For
(Dependency topology) :::image type="content" source="media/link-work-items-support-traceability/affected-by-cmmi.png" alt-text="Screenshot that shows a conceptual diagram of Consumes From topology."::: :::image type="content" source="media/link-work-items-support-traceability/affects-cmmi.png" alt-text="Screenshot that shows a conceptual diagram of Produced For topology."::: :::column-end::: :::column span=""::: System.LinkTypes.Remote.Dependency-Forward
System.LinkTypes.Remote.Dependency-Reverse
Topology type: Dependency
Link category: System-defined
:::column-end::: :::column span=""::: Use this directional link to create dependencies between work items defined in different organizations, as long as the same Microsoft Entra ID manages them. People typically use this to track change requests linked to requirements across org boundaries. :::column-end::: :::row-end::: :::row::: :::column span=""::: Remote Related
:::image type="content" source="media/link-work-items-support-traceability/related-network.png" alt-text="Screenshot that shows a conceptual diagram of Remote Related topology."::: :::column-end::: :::column span=""::: System.LinkTypes.Remote.Related
Topology type: Network
Link category: System-defined
:::column-end::: :::column span=""::: Use this nondirectional link to relate work items defined in different organizations, as long as the same Microsoft Entra ID manages them. :::column-end::: :::row-end:::

::: moniker-end

::: moniker range="< azure-devops"

Custom link type

Create custom link types, export and import link-type definitions, and delete, activate, deactivate, or reactivate custom link types. See:

::: moniker-end

List link types

You can list link types using supported command-line tools.

::: moniker range="azure-devops"

az boards work-item relation list-type

List link types supported by your organization with the az boards work-item relation list-type command or the Work Item Relation Types - List REST API. For details, see Get started with Azure DevOps CLI.

az boards work-item relation list-type [--org]

Optional parameters

  • org: Azure DevOps organization URL. You can configure the default organization using az devops configure -d organization=ORG_URL. Required if not configured as default or picked up using git config. Example: --org https://dev.azure.com/MyOrganizationName/.

Example

The following command lists the work item link types in table format that are defined for the fabrikam organization.

az boards work-item relation list-type --org fabrikam --output table
Name                  ReferenceName                                                Enabled    Usage
--------------------  -----------------------------------------------------------  ---------  ------------
Produces For          System.LinkTypes.Remote.Dependency-Forward                   True       workItemLink
Consumes From         System.LinkTypes.Remote.Dependency-Reverse                   True       workItemLink
Duplicate             System.LinkTypes.Duplicate-Forward                           True       workItemLink
Duplicate Of          System.LinkTypes.Duplicate-Reverse                           True       workItemLink
Referenced By         Microsoft.VSTS.TestCase.SharedParameterReferencedBy-Forward  True       workItemLink
References            Microsoft.VSTS.TestCase.SharedParameterReferencedBy-Reverse  True       workItemLink
Tested By             Microsoft.VSTS.Common.TestedBy-Forward                       True       workItemLink
Tests                 Microsoft.VSTS.Common.TestedBy-Reverse                       True       workItemLink
Test Case             Microsoft.VSTS.TestCase.SharedStepReferencedBy-Forward       True       workItemLink
Shared Steps          Microsoft.VSTS.TestCase.SharedStepReferencedBy-Reverse       True       workItemLink
Successor             System.LinkTypes.Dependency-Forward                          True       workItemLink
Predecessor           System.LinkTypes.Dependency-Reverse                          True       workItemLink
Child                 System.LinkTypes.Hierarchy-Forward                           True       workItemLink
Parent                System.LinkTypes.Hierarchy-Reverse                           True       workItemLink
Related               System.LinkTypes.Related                                     True       workItemLink
Remote Related        System.LinkTypes.Remote.Related                              True       workItemLink
Attached File         AttachedFile                                                 True       resourceLink
Hyperlink             Hyperlink                                                    True       resourceLink
Artifact Link         ArtifactLink                                                 True       resourceLink

The default json format provides additional information about the attributes defined for the link types. For example, the information for the link types Produces For and Consumes From are listed as follows.

  {
    "attributes": {
      "acyclic": true,
      "directional": true,
      "editable": false,
      "enabled": true,
      "isForward": true,
      "oppositeEndReferenceName": "System.LinkTypes.Remote.Dependency-Reverse",
      "remote": true,
      "singleTarget": true,
      "topology": "dependency",
      "usage": "workItemLink"
    },
    "name": "Produces For",
    "referenceName": "System.LinkTypes.Remote.Dependency-Forward",
    "url": "https://dev.azure.com/mseng/_apis/wit/workItemRelationTypes/System.LinkTypes.Remote.Dependency-Forward"
  },
  {
    "attributes": {
      "acyclic": true,
      "directional": true,
      "editable": false,
      "enabled": true,
      "isForward": false,
      "oppositeEndReferenceName": "System.LinkTypes.Remote.Dependency-Forward",
      "remote": true,
      "singleTarget": true,
      "topology": "dependency",
      "usage": "workItemLink"
    },
    "name": "Consumes From",
    "referenceName": "System.LinkTypes.Remote.Dependency-Reverse",
    "url": "https://dev.azure.com/mseng/_apis/wit/workItemRelationTypes/System.LinkTypes.Remote.Dependency-Reverse"
  },

::: moniker-end

witadmin listlinktypes

You can list link types supported for your project collection using the witadmin listlinktypes command-line tool or the Work Item Relation Types - List REST API command.

Here is a list of the link types for the fabrikam-sever default collection:

C:\Program Files (x86)\Microsoft Visual Studio\2019\Community\Common7\IDE\CommonExtensions\Microsoft\TeamFoundation\Team Explorer>witadmin listlinktypes /collection:http://fabrikam-server/DefaultCollection

Reference Name: Microsoft.VSTS.TestCase.SharedParameterReferencedBy
Names: Referenced By, References
Topology: Dependency
Is Active: True

Reference Name: Microsoft.VSTS.Common.TestedBy
Names: Tested By, Tests
Topology: Dependency
Is Active: True

Reference Name: Microsoft.VSTS.TestCase.SharedStepReferencedBy
Names: Test Case, Shared Steps
Topology: Dependency
Is Active: True

Reference Name: System.LinkTypes.Duplicate
Names: Duplicate, Duplicate Of
Topology: Tree
Is Active: True

Reference Name: System.LinkTypes.Dependency
Names: Successor, Predecessor
Topology: Dependency
Is Active: True

Reference Name: System.LinkTypes.Hierarchy
Names: Child, Parent
Topology: Tree
Is Active: True

Reference Name: System.LinkTypes.Related
Name: Related
Topology: Network
Is Active: True

Link type attributes

The following table provides descriptions for each of the link type attributes returned by Azure Boards CLI or the REST API.

:::row::: :::column span=""::: Attribute :::column-end::: :::column span="2"::: Description :::column-end::: :::row-end:::

:::row::: :::column span=""::: Names, name :::column-end::: :::column span="2"::: Specifies the friendly name assigned to the link types. Directional links are defined in pairs, therefore include a forward and reverse name. :::column-end::: :::row-end::: :::row::: :::column span=""::: Reference name, referenceName :::column-end::: :::column span="2"::: Specifies the name assigned to the link type or link type pair.
:::column-end::: :::row-end::: :::row::: :::column span=""::: acyclic :::column-end::: :::column span="2"::: Indicates whether the link type allows or (true) or restricts (false) circular relationships. For example, tree type links restrict circular relationships. For more information, see LinkTypes elements reference. :::column-end::: :::row-end::: :::row::: :::column span=""::: directional :::column-end::: :::column span="2"::: Indicates whether the link type is directional (true) or not (false). Directional link types get defined in pairs with a forward and reverse component. For more information, see LinkTypes elements reference. :::column-end::: :::row-end::: :::row::: :::column span=""::: editable :::column-end::: :::column span="2"::: Indicates whether the link type is editable (true) or not (false). You can only add and edit custom link types for on-premises deployments using witadmin Manage link type command-line tool. System link types always have editable=false.
:::row-end::: :::row::: :::column span=""::: Is Active, enabled :::column-end::: :::column span="2"::: Indicates whether the link type is active (true) or not (false). You can only use custom link types for on-premises deployments using the witadmin Manage link type command-line tool. :::column-end::: :::row-end::: :::row::: :::column span=""::: isForward :::column-end::: :::column span="2"::: Indicates whether the link type specifies the forward link (true) or not (False) within a link type pair. :::column-end::: :::row-end::: :::row::: :::column span=""::: oppositeEndReferenceName :::column-end::: :::column span="2"::: Specifies the reference name of the link type that defines the link in the opposite direction of a link type pair. :::column-end::: :::row-end::: :::row::: :::column span=""::: remote :::column-end::: :::column span="2"::: Indicates whether the link type supports linking to a remote work item (true) or not (False). Link types with remote=false require that the target work item resides in the same organization or collection as the origin work item.
:::column-end::: :::row-end::: :::row::: :::column span=""::: singleTarget :::column-end::: :::column span="2"::: Indicates whether the link type allows for more than one target (false) or is restricted to a single target (true).
:::column-end::: :::row-end::: :::row::: :::column span=""::: topology :::column-end::: :::column span="2"::: Specifies the topology type: dependency, network, and tree. For descriptions, see Link type topologies and restrictions. :::column-end::: :::row-end::: :::row::: :::column span=""::: usage :::column-end::: :::column span="2"::: Specifies the usage type: resourceLink or workItemLink. The workItemLink value indicates a link type that links two work items. The resourceLink value indicates a link type used to link a work item to a resource, such as a URL or attachment.
:::column-end::: :::row-end::: :::row::: :::column span=""::: url :::column-end::: :::column span="2"::: Lists the attributes of the link type in json format.
:::column-end::: :::row-end:::

Related content