> For the complete documentation index, see [llms.txt](https://docs.currents.dev/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.currents.dev/resources/integrations/jira/usage.md). # Usage Learn how to use Currents Jira Integration 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.

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:

Example of an new Jira issue created from Currents

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

Example of linking test failure to an existing Jira issue

Example of a Jira issue comment originating from Currents

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

### 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 This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation by asking a question. Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters: ``` GET https://docs.currents.dev/resources/integrations/jira/usage.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case. 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.