---
title: "linkIssue"
canonical: "https://support.appfire.com/space/PSJ/15483554/linkIssue"
format: markdown
---
> Macro (aura-html)


|  |  |  |  |
| --- | --- | --- | --- |
| **Syntax** | linkIssue(issueKey1, issueKey2_or_url, issueLinkTypeName) | **Package** |  |
| **Alias** |  | **Pkg Usage** |  |

## Description

> Macro (excerpt)
> 
> Links two issues by a specified link type name. First issue will have the outward description of the link type, the second issue will have the inward description of the link type.

Links two issues by a specified link type name. First issue will have the outward description of the link type, the second issue will have the inward description of the link type.

## Parameters

| Parameter name | Type | Required | Description |
| --- | --- | --- | --- |
| issueKey1 | String | Yes | Key of the first issue to be linked. |
| issueKey2_or_url | String | Yes | Key of the second issue to be linked or the URL. |
| issueLinkTypeName | String | Yes | Issue link type name. |

## Return Type

**None**

The returned value has no meaning.

## Examples

### Example 1

```
linkIssue(key, "TST-123", "Relates");
//key represents the key of current issue, "TST-123" the key of the issue it will be linked to.
```

Result: current issue is linked to issue "TST-123" by Relates link type, such that "TST-123" relates to current issue and vice versa.

### Example 2

```
linkIssue("TST-123", "TST-234", "Blocks");
```

Result: "TST-123" issue is linked to issue "TST-234" by Blocks link type, such that "TST-123" blocks "TST-234" and "TST-234" is blocked by "TST-123".

### Example 3

```
linkIssue("TST-123", "https://confluence.example.com", "Confluence Documentation");
```

As a result, the TST-123 issue will be linked to [https://confluence.example.com](https://confluence.example.com) with the "Confluence Documentation" link text.

## See also

> Macro (contentbylabel)