# Linking existing Jira work items

Find the Jira app in the right-side panel and click **Link existing work item (1)** to get started.

<figure><img src="https://3976155500-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LGUXywqOAgHcx2c0YGM%2Fuploads%2FSiTO4ko0CuodDL2qsi3l%2FLink%20issue%20-%20start.jpg?alt=media&#x26;token=e27b8a89-fc9c-49c7-afa1-9fb69a395041" alt=""><figcaption></figcaption></figure>

The app shows a selection of the five most recently used work items. If you do not see the work item you are looking for, use the **work item search (1)** to find the work item.&#x20;

You can search by work item key (e.g., ENG-25) or by text directly. If you require additional search options, you can also search by JQL using the `jql:` prefix.&#x20;

{% hint style="info" %}
**Available search options**

* **By work item key:** type the work item key into the search box.\
  Example: **ENG-25**
* **By text:** type free-form text into the search box.\
  Example: **As a user, I want to link a conversation**
* **By JQL:** type `jql:` followed by your JQL query into the search box.\
  Example: **jql: issuetype = bug**
  {% endhint %}

When you have found the work item that you would like to link, **click on it to link (2)**.

<figure><img src="https://3976155500-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LGUXywqOAgHcx2c0YGM%2Fuploads%2FWHQhxvatPuVp0tOGdCBN%2FLink%20issue%20-%20select.jpg?alt=media&#x26;token=c5098988-8816-4b63-bba3-cd217534976b" alt=""><figcaption></figcaption></figure>

A confirmation message will indicate that the link has been established successfully. Click **Done** to return to the app home screen, where you can now see the **linked Jira work items (1)** and **an internal note (2)** to record the event.

{% hint style="info" %}
**Paid features**

Note that the linked Jira work items (1) only show up in the sidebar if you have the [Jira companion app](https://marketplace.atlassian.com/apps/1217371/intercom-for-jira?hosting=cloud\&tab=overview) installed and licensed.
{% endhint %}

<figure><img src="https://3976155500-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LGUXywqOAgHcx2c0YGM%2Fuploads%2FXAdBHzdDIUDHlz3H6VUf%2FLink%20issue%20-%20done.jpg?alt=media&#x26;token=ab161a58-95af-4fb6-904a-666c7b907209" alt=""><figcaption></figcaption></figure>
