Skip to content

Guides

Draw, change or remove a link

Link two work items by dragging a line between their cards, link to a work item that is not on the map, and change or remove a link. Every change is saved in Jira.

Links you draw on the map are ordinary Jira links, saved as you make them. You can only link work items you are allowed to edit in Jira.

  1. Point at the card the link starts from. Small dots appear on its edges.
  2. Drag from a dot towards the other card. A note by the pointer says what letting go will do.
  3. Let go on the other card when the note reads Release to link to and its key.
  4. Pick the link type, for example blocks, and press Enter.

If the two are already linked, the note reads Already linked to and the key.

  1. Point at the card the link starts from and drag from one of its dots.
  2. Let go on an empty spot of the map. The note reads Release to find or create a work item. A Link to… box opens there.
  3. Type a key or a few words of the title. The search covers this space and others.
  4. Pick the link type.
  5. Pick the work item and press Enter.
Drop the line, search, Enter. Both cards flash once the map has redrawn.

To create the missing work item instead, choose New work item in the box. It is created and linked in one go.

Press Esc to close the box without linking.

  1. Find the small label on the line. It names the link type.
  2. Click the label.
  3. Pick another type from the list.
  1. Click the label on the line.
  2. Click ×.
The label’s menu lists every link type; × removes this link.

Add a work item inside an epic

  1. Click the epic’s card.
  2. Above it, click Add a child work item.

To create a work item that is not inside an epic, click Create work item, the blue + in the toolbar.

Good to know

  • When a link is saved, the map rearranges itself and the two cards flash, so you can see where they went.
  • When two work items are linked in more than one way, each link has its own label.
  • Lines from an epic to its stories are labelled only when you point at them.