## Linking issues

The **Links** section lets you associate an issue with other issues in the system — for example when issues share the same root cause, one blocks another, or one is a continuation of another.

The list of links is displayed on the issue details page. Each entry shows a directional description of the relation and the linked issue's number.

## Adding a link

Click **Links** in the issue actions menu. A side panel opens showing existing links and a form to add a new one.

In the form:
1. Choose a **relation type** from the dropdown:
   - **duplicates** — this issue is a duplicate of another
   - **continues** — this issue is a continuation of another
   - **blocks** — this issue blocks the progress of another
   - **is linked to** — a general thematic association
2. Type the **issue number** you want to link and select it from the results.
3. Click **Link issues**.

The link is bidirectional — it appears on both issues' pages, with the relation label shown from each side (e.g. "blocks" / "is blocked by").

## Removing a link

In the side panel, each link has a remove icon. Click it and confirm in the dialog to permanently delete the link from both issues.

## Navigation

Clicking a linked issue's number in the links list navigates to that issue's details page.

---

## FAQ

### Does linking issues affect their workflows?
No. A link is purely informational — it does not synchronise steps, statuses, or data between issues. The relation type (e.g. "blocks") is a descriptive label, not an automation trigger.

### What relation types are available?
There are four types: **duplicates**, **continues**, **blocks**, and **is linked to**. Each relation is directional — on the issue page it is displayed as either the outgoing or incoming form (e.g. "blocks" vs. "is blocked by").

### Can I link issues of different types?
Yes. Links work between issues regardless of their types.

### How do I remove a link?
Open the **Links** panel from the issue actions menu and click the remove icon next to the link. The operation requires the appropriate permissions.

### How many issues can be linked together?
There is no limit to the number of links — one issue can be linked to any number of other issues.

### I cannot see the add or delete options — why?
Access to individual operations is controlled by permissions. If a permission is missing, the corresponding option is not shown. Contact your system administrator.