# 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>


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.toolsplus.io/intercom/jira-cloud-for-intercom/guides/intercom-teammates/linking-existing-jira-issues.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.