> For the complete documentation index, see [llms.txt](https://docs.toolsplus.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.toolsplus.io/intercom/jira-cloud-for-intercom/guides/intercom-teammates/linking-existing-jira-issues.md).

# 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="/files/dAY91liwxGW83Ljh8OCP" 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="/files/z2VM9s1sHmKAhHCzugAI" 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="/files/PSAjZLUamBqkhc2heb75" alt=""><figcaption></figcaption></figure>
