Link Healthcheck – Documentation

Getting started

Install Link Healthcheck from the Atlassian Marketplace (a Jira admin approves the permissions). Every site gets a 30-day free trial.
Open any Jira project and click Link Healthcheck in the project tabs (or under Apps).
The scan starts by itself. No configuration is needed.

Reading the screen

Verdict: one sentence at the top that says what to fix first.
Four tiles: Health score (0 to 100, with the change since the previous scan day), Open findings (by severity), Issues analysed (opens them in Jira) and Fix first (how many points the top five fixes would add).
One-click fixes: when some problems can be fixed automatically, a block lists them, with Fix all.
Overview: Where the problems are (by family: Dependencies, Epics & hierarchy, Traceability), Path to 100 (what each type of problem costs), Fix first and the score trend.
Findings: every problem in one table, most severe first, with filters. Checks: what each check means and how to fix it. Settings: see below.

The 8 checks

Check	Severity	What it finds	One-click fix
Circular dependency	Critical	Issues that block each other in a loop, so none of them can start	No
Open issue under a closed parent	Warning	A parent (usually an epic) is Done but this child is still open	No
Empty epic	Warning	An open epic with no child issues, after a grace period	No
Untraced bug	Warning	A bug with no parent and no link	No
Blocked by a stalled issue	Warning	The blocker is open but untouched for a long time	No
Blocker already resolved	Info	Still "blocked by" an issue that is Done	Remove link
Epic ready to close	Info	Every child is Done but the epic is still open	Close epic
Orphan work item	Info	No epic and no link at all	No

Epics, sub-tasks and Done issues are never reported as orphans. Done issues never count in a dependency loop.

Health score

The score goes from 0 to 100. Each problem costs points by severity (critical 10, warning 4, info 1), relative to the number of open issues (at least 10). 90 and above is Healthy, 70 to 89 Needs attention, below 70 At risk. One point per day is kept for 30 days to draw the trend.

One-click fixes

Two problems can be fixed from the app: one at a time, or up to 20 at once with Fix all. The app first lists exactly what will change and asks for confirmation. It re-reads Jira just before each change and uses your own Jira permissions, so the change appears under your name in the issue history. If the epic workflow needs extra fields, the app tells you to close it in Jira instead.

Settings (project administrators)

Turn each check on or off for the project.
Stalled blocker threshold: 7 to 180 days (default 30).