Relate items to other items

Relate items to each other for coverage and to see how one item impacts others.

You can view and manage related items from one single point, which graphically displays all of an item's relations.

Some relations are created by ALM Octane automatically, such as the links between a test and its runs.

Relate items

  1. While viewing the details of an entity, click Relations.

    A graphical representation of all items linked to the current item is displayed.

    When several items of the same type are related to the current item, they are displayed one behind the other as a group. Additional summary details are displayed for the group, such as the total number of items in the group, and their status.

  2. To add a relation, click Add Relation in the toolbar, and select the type of item to which you want to link.

  3. Select the items from the displayed list, and click Select.

  4. You can also: 

    To... How?
    Drill down to the details of an item Click the ID in the title bar of an item's node
    Add a relation to an item Click in the title bar of an existing item
    Delete a related item

    In the grid view, select an item and click in the toolbar

    Team members can only delete items that they have created.

    Expand / collapse nodes

    Click + or - in the lower right corner of a node representing a group of items

    This switches between:

    • A list of multiple items displayed as one node behind the other

    • The multiple items displayed side-by-side

    Zoom in / out of the diagram Click anywhere in the chart, and use the mouse wheel to zoom in / out of the diagram
    Switch between the graphic chart display and a grid view Click one of these: 

Back to top


  • In the Backlog module, relate a test to a user story or a feature for tracking coverage.

  • Report defects while running a test. When you create the defects while using the Manual Runner, the defects are automatically related to the test.

  • View the relationship between a test and test suites to which it is linked.

Test Suites
  • Relate a user story or feature to a test suite.

  • View relationships between a test suite and other items. To view a list of related tests, go to the Tests tab.


  • Relate defects to a run, even if you didn't report them during the run.

  • When you run a test, its corresponding test run is automatically related to the test.

  • In the Quality module, relate a defect to an automated test.

  • Relate defects to each other. You might want to create a set of defects that address the same problem on different releases or for different environments.

Back to top