• Products
  • Documentation
  • Resources

Link Jira issues from your whiteboard

Adding connector lines between Jira issues on the whiteboard helps you visualize the relationships, hierarchies, and dependencies between different pieces of work. These lines can then be turned into issue links in Jira. Any link between two Jira issues created in a whiteboard will update the “Linked issues” field in Jira.

Whiteboards only support linking issues from Jira Cloud sites.

Creating a link between Jira issues on the whiteboard
  1. Add Jira issues to your whiteboard. You can do this by:

  2. Connect the Jira issues with a line.

  3. Select the line.

  4. Select the Link issues button on the floating toolbar.

  5. From the menu that appears, choose the type of link (for example, "blocked by").

  6. To change the direction of the link, select the Reverse icon that appears to the right of the menu.

  7. Select Link.

  8. The line now has a label that shows the link you created in Jira.

A GIF showing the process of linking two issues

You can edit the links you’ve created from the whiteboard (for example, changing "blocks" to “depends on”). Editing links from the whiteboard will update the link in Jira.

 

To edit a link:

  1. Select the line between the two Jira issues.

  2. Select the Edit link button from the floating toolbar.

  3. From the menu that appears, change the type of link.

  4. To change the direction of the link, select the Reverse icon that appears to the right of the menu.

  5. Select Update.

  6. The line label now shows the link you updated in Jira.

Editing two issues linked on a whiteboard

You can remove links between Jira issues by unlinking them. Unlinking issues from the whiteboard will also remove the link in Jira.

 

To remove a link:

  1. Select the line between the two Jira issues.

  2. Select the Edit link button from the floating toolbar.

  3. Select the Unlink icon that appears to the right of the menu.

  4. Select Unlink.

  5. The line label is now removed, and the link has been removed in Jira.

Removing the link between two issues on a whiteboard

You can also remove links from inside Jira. Links removed from inside Jira will also be removed from the whiteboard. Learn more about removing links from Jira.

Deleting and disconnecting lines

Deleting or disconnecting a line doesn’t remove links between issues in Jira.

Still need help?

The Atlassian Community is here for you.