Item Links
Links establish traceability relationships between items. They are essential for tracking how requirements flow to tests, how hazards are mitigated, and more.
Link Types
Link types are configured in Link Types and define the allowed relationships. Each has a forward and a reverse label, and rules restricting which item types can be connected. The built-in defaults:
| Link Type | Reverse | Use |
|---|---|---|
| derives from | derived by | Requirement decomposition |
| verified by | verifies | Requirement → Test traceability |
| mitigates | mitigated by | Requirement → Hazard mitigation |
Creating Links
On an item’s detail page, the Links card shows one section per link type applicable to the item’s type:
- Use that section’s search input to find the target item by ID or title
- Click the item to add the link
- Click Save in the page header to persist — link edits are batched with your other changes
Items that are already linked (and the item itself) are excluded from search results. If the link type has custom attributes, they appear as editable columns in the links table; a small settings icon on a link badge indicates it carries attribute values.
You can also link items directly from the items list with link mode — see Working with Items.
Removing Links
Click the X button next to a link to remove it, then Save.
Incoming Links
The Incoming links card (below outgoing links) shows items that link to the current item, grouped by the link types’ reverse labels. Incoming links are editable too — add or remove them here and they are saved together with the page. Link attributes are owned by the source item, so they aren’t edited from the incoming side.
Suspect Links
When a linked item is modified after a link was created, the link can become suspect — indicated by an amber warning triangle. This alerts you that the relationship may need to be re-evaluated. Which changes mark links suspect (and for which link types) is configurable — see Suspect Links configuration.
Managing Suspect Links
- Review Changes — click the amber triangle next to a suspect link to open a diff dialog showing exactly what changed in the target since the link was last known good
- Acknowledge — after reviewing, click Acknowledge in the dialog to clear that link’s flag
- Acknowledge All — each link-type section with suspect entries offers an Acknowledge All shortcut
Suspect state is tracked against the git commit of the last known-good version, so the diff shows precisely what was modified since.
Querying by Links
You can filter items by their link relationships using the Query Language:
verified_by IS EMPTY
links_to IN (type = testcase)
has_suspect_links = true