# Find and fix a circular dependency

> Use Backlog health to find work items that wait on each other in a circle, see them on the map, and remove the link that should not be there.

Section: Guides · Web page: https://visualbacklog.app/docs/guides/fix-a-circular-dependency

A circular dependency is a set of work items that wait on each other in a circle: A
blocks B, B blocks C, and C blocks A. None of them can start. Backlog health finds
these for you.

[Screen recording: Pointing at a circular dependency in Backlog health, then showing only the work items involved](https://visualbacklog.app/landing/clips/health-1.mp4)

*Point at a circular dependency, then show only the work items in it.*

## Find it

1. At the right of the map, click the second icon, **Backlog health**. A red number on
   the icon is how many problems were found. No number means none.
2. Look under **Circular dependencies**. Each row is one circle, named by its first and
   last work item, for example *NOVA-21 → 1 more → NOVA-42*.
3. Point at a row. The work items in that circle light up on the map with a red outline.

![The Backlog health panel open, listing two circular dependencies; four cards on the map have a red outline](https://visualbacklog.app/docs/health.webp)

*Backlog health, with the circular dependencies listed first.*

## Look at it

1. Click the row. It opens to list each link in the circle, such as
   *NOVA-21 blocks NOVA-24*, and the map moves to those work items.
2. Read the links in order. One of them is usually wrong: entered the wrong way round,
   or left over from an earlier plan.

![A circular dependency opened in Backlog health, showing its three links; the map is zoomed in on the cards with red outlines](https://visualbacklog.app/docs/health-loop.webp)

*A circle of three links, and its work items on the map.*

## Fix it

1. Decide which link should not be there.
2. At the right of that link’s row, click the icon to break the circle there. Its
   tooltip names the link it will remove, for example
   *Break the cycle here: remove NOVA-42 blocks NOVA-21*.
3. Confirm. The link is removed in Jira, and the circle leaves the list.

To change your mind before confirming, choose **Keep this link**.

## If part of the circle is hidden

- When a circle is inside a folded card, that card turns red. Click the row to open it.
- When a link type in the circle is hidden by the link type filter, Backlog health says
  so, with a **Show** link to bring it back.

## See only the circles

1. In the layout settings at the far right, click **Show circular dependencies**.
   Everything that is not part of a circle fades.
2. Click it again to bring the rest back.

![The map with Show circular dependencies on: five cards with red outlines stay bright and everything else is faded](https://visualbacklog.app/docs/cycles-only.webp)

*Only the work items in a circular dependency stay bright.*

## Good to know

- You can only remove a link from work items you are allowed to edit in Jira.
- Backlog health checks everything that was loaded, including folded work. The other
  checks it runs are in the [Backlog health reference](https://visualbacklog.app/docs/reference/backlog-health.md).
