# Usage

Once enabled, you can create new or link an existing Jira issue directly from test execution details in Currents. You can also explore previously created or linked issues that are linked to the current test.

## Browse Linked Jira Issues

1. Open any test execution details in Currents
2. Look for the **Jira** icon (only visible when integration is enabled). If there existing (previously linked) Jira Issues related to the test, you will see a counter next to Jira icon.

<figure><img src="/files/JkmUmqH6mbaVVdNZjITD" alt=""><figcaption><p>A test has 2 linked Jira Issues</p></figcaption></figure>

<figure><img src="/files/UYuwh4VZwIjSkEnBpVJ9" alt=""><figcaption><p>A test has no existing Jira Issues</p></figcaption></figure>

By clicking on the icon you can:

* Explore linked Jira Issues
* Create a new Jira Issue
* Link an additional existing Issue

## Create a New Jira Issue

To create a new issue:

1. Select the **Jira Project** and **Issue Type**
2. Enter **Issue Title** and **Description** (optional)
3. Toggle **Include Details** to automatically add test context (error messages, stack traces, etc.)
4. Click **Create Issue**

Example of a newly created issue:

<figure><img src="/files/rqTM7mkqAydYbCSlQFso" alt="Example of New Jira Issue creation form"><figcaption><p>Example of New Jira Issue creation form</p></figcaption></figure>

<figure><img src="/files/6FPiTLvEVsZybizOUqBe" alt="Example of an new Jira issue created from Currents"><figcaption><p>Example of an new Jira issue created from Currents</p></figcaption></figure>

## Link an Existing Jira Issue

To link and comment on an existing issue:

1. Select a **Jira Project**
2. Search for the issue by typing its title (results limited to 50 items)

   *Note: For more specific results, use more detailed search terms.*
3. Enter your comment text
4. Toggle **Include Details** to add test context
5. Click **Add Comment**

Example of commenting on an existing issue:

<figure><img src="/files/E76nZwTSvXjYu2btR10B" alt="Example of linking test failure to an existing Jira issue"><figcaption><p>Example of linking test failure to an existing Jira issue</p></figcaption></figure>

<figure><img src="/files/ZYYwglRVSR5A2jVacsGl" alt="Example of a Jira issue comment originating from Currents"><figcaption><p>Example of a Jira issue comment originating from Currents</p></figcaption></figure>

### Browsing Linked Jira Issues

Open Jira dialog to list existing Jira Issues linked to the current test.

* Click on the Jira Issue ID to explore its details (opens a new tab)
* Click 💬 to add a new comment to an existing issue
* Click ⛓️‍💥 to unlink Jira Issue from the test
* Click **Add Jira Issue** to create new or link an additional Jira Issue

<figure><img src="/files/QpY8AwFgVMqtai331Y3Q" alt=""><figcaption><p>Listing Jira Issues related to the test</p></figcaption></figure>

### Notes

* The integration creates one-way links from Currents to Jira
* Deleting or closing Jira Issue do not remove those issues in Currents - you will need to do that manually
* Comments include a link back to the relevant test in Currents


---

# 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.currents.dev/resources/integrations/jira/usage.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.