# Jira link: create and/or link Jira issues to aqua tickets

To connect existing Jira issues to aqua tickets, you need to set up the integration with Jira first. 

In order to configure the integration, open the 'Integrations' page, and you'll land on the 'Global' tab. Here, you can set up a single integration that applies to all the projects you have in aqua.

<figure><img src="https://lh7-us.googleusercontent.com/9QxY3iVQ0Ei04FeHZyuzLiUSLabg_6LqT1Jvwt_MMTcb3Jt6VODusyHOIUvoVtPd7ohSQNAKdYfLCrpC3c4ZHRGs2wdPTjYvR5wHN8QKAzJIXu2vWAYyFSTkpRnzk85YlN0AqpiwBHCZKC5d2IkZi7k" alt=""><figcaption></figcaption></figure>

<figure><img src="https://lh7-us.googleusercontent.com/xp9kuYNIurCfnfDzwve0IlL06n0YW8RuXDglJI31RpXBZ0vim0QWFLD_v989JTJMtV3tf-lTboIl4k46wgKPt4ZrA7aw2M5GVF1uwJ3sCTHJHXJ_qTWOom4iSCnto8XiSVe-NUiTRqeFAaiPmaHWY64" alt=""><figcaption></figcaption></figure>

Choose the integration, such as Jira, and then click the 'Configure' button.&#x20;

<figure><img src="https://lh7-us.googleusercontent.com/f6SrIk7c9v5aMdW8RJ_0xa_7qFDagKZF6Ye-uK_9zKArgfbTKCpFCIOHai2aG9lBdyJdQYmrFEamcJ6z_Ejl3xuRf2Q0Xy1sVhibcgUaEXjvjfc5TKY8jbh1xf6JN9bXwfIJUCRtxRKMAMxenfpyuc8" alt=""><figcaption></figcaption></figure>

Enter all the necessary details and click 'Check connection.' If all your credentials are correct, you'll see the following message:

<figure><img src="https://lh7-us.googleusercontent.com/0lbkDHtmzyTwz53G8JXrYLm2P1ezIXtnOt_V_D2peoiOczErqRhG7ShQT5lCSPU0uJPLKeoNjviTrTG5Lxfo2PiH5pc80iwjZs7DIOg1BukyjTMtS6jLqwTMQGBreV6quPwJMNMAebTAQ4G2i-vSvzw" alt=""><figcaption></figcaption></figure>

If your credentials are incorrect, you'll encounter the following message:

<figure><img src="https://lh7-us.googleusercontent.com/v6De5lmK1CHjjASTK7neApd9Sl3opzXmI8LV4abSReXglS8HZk1YttvRyrBEKWc8QVAym6oRtAC4XQAM6_pqaB2sNuGMGVi6BfCb8zW7hQmZ4TGQ2vsB1J9XQ7Jeo8sLIjIQsSdxpfRC80uye1ejRSY" alt=""><figcaption></figcaption></figure>

To finish the integration set up, don’t forget to click the ‘Save’ button.

\
You can also set up the integration on a project level, either from the main Integrations page or within the project settings.

Once you've created an integration on a project level, you'll find a tile under the project tab that displays the added integration and which project it's associated with.

<figure><img src="https://lh7-us.googleusercontent.com/0513-kUVuYxut7Fr0qRl1OLjpaiYn6rH9QzkjD0d3hMz3iCWEmShQGBjthv5R756CS0DAGDNdyaCGZEHvLlznb4HQYijSnyTaTB-PafbB_JgaysK-OxqjSXaaTrwU3yNKiVp3253fCe6feMvhUx7owg" alt=""><figcaption></figcaption></figure>

It's important to note that project-level configuration takes precedence over the global configuration.

\
Additionally, moving forward, if your project is put on hold, or you need to make adjustments, there's no need to remove the integration entirely. You can simply disable it and re-enable it as needed. <br>

<figure><img src="https://lh7-us.googleusercontent.com/p1FOw0CbndJgbw-3186SVPht1yhDBPuO06ywji3ukia8d5qoGNAIho22J01E4ScrE1oyJQ6FWMR4Gvc6Y17FLhiIBTSjojiSTd_n0tjKN2Nk2a69KEj6f4BFX3Ap7944ZgR1CEgAyp0WUb-TJ1GcgoM" alt=""><figcaption></figcaption></figure>

This means that users won't have the ability to preview or link issues or tickets to aqua projects while it’s disabled, but everything becomes available again as soon as the integration is re-enabled.

We also added the page with aqua apps that you can download and utilise for free. Learn more [here](https://docs.usecapture.io/help-articles) about Capture and[ here ](/documentation/integrations/aqua4jira-plugin-cover-jira-issue-with-aqua-test-cases.md)about the Jira plugin if you haven’t used it yet.

<figure><img src="https://lh7-us.googleusercontent.com/EqC4UZtNaOMPFOy85p66fIiDmSYkWL7i4KXgXNG-lX6ADiOvsiB97urkWtdvqtTUNNru16OygpOWxxIlX2RlbQ1fZQFr37z8t2z2wEVY4sByf2H_8mCCYFM6LHu0y8Lf7SqEpZywEVGl0JPM1-dpioI" alt=""><figcaption></figcaption></figure>

<mark style="color:blue;">Got a wish-list of integrations you'd love to see? We're all ears! Access the survey from the ‘Integrations’ page and tell us what you're dreaming of.</mark>

<figure><img src="https://lh7-us.googleusercontent.com/qGrX5l7f_GmrzfiqNAOmW_Qh3trUoJhB3ZSlNvZ12x9X9mit9IASddkn4cwWBzjC2hmUuc0c0mXid_6IWYoYGSZtY1GWqdn_EWTQbcITi-0j5ng-MQmftoFcyrPsfaXvPeWspr8HEqj927ACz8yeRVg" alt=""><figcaption></figcaption></figure>

\ <br>

Once the integration is in place, open the desired aqua item, navigate to the ‘Dependencies’ tab, and then click the ‘Connect Jira issue’ button.

<figure><img src="https://lh7-us.googleusercontent.com/UvLV0xlrnonCHxPozKZONxsv0AmNmcdGHMnrpZAFt4HSMrJR1uk0sVy3GIB68rrOheBn0UlCOlM84nDtVPMffi87HmxBzp1HwpZq_u2NIFHBB6pbdH_AJdWjfV1HtsAzCLTobgveYshcB4iC_1PoW_E" alt=""><figcaption></figcaption></figure>

When the pop-up opens, provide the IDs of the Jira issues (separated by commas) and then click the ‘Connect’ button.&#x20;

<figure><img src="https://lh7-us.googleusercontent.com/7s0zrWwaDD4LJ4o3aPWow1Oa-hyyoeQJvIJcHkKsAw_e1ZYGzogd5PjhWOntPqlLbYeOASATsh0nrGBfr5fbZ-fFs3dIia4J4Zd8Sl8MMF_O7GlDlmlq3zHwKcRlW4JY3vasuDWuThb2qIfFoyoNAe8" alt=""><figcaption></figcaption></figure>

All referenced issues will be linked to the target aqua item.&#x20;

{% hint style="info" %}
Please note, there is a limit of 10 IDs that you can provide at once. You will be able to link more items by going through the same steps again.
{% endhint %}

<figure><img src="https://lh7-us.googleusercontent.com/JP4R7UVlJCZcbTfMVxsUm6kMd9sJqViIamhOzpD6o958qBxCb27UPhkq0AHzJCh4oWQ2pqL_Qq2g4g9rX8b8f4L8pBh-PeLoov657LahxogwU4GoJL1eNGrjazuaquw0HA_4ph44X2ZVbagnF-xJ938" alt=""><figcaption></figcaption></figure>

In case you want to create a new Jira issue and link it to the aqua item, just click the ‘New issue’ button and, once you save it on the Jira side, go back to aqua and provide the ID.<br>

You can use the same flow to connect multiple existing or new Jira issues to aqua’s test executions. Just click the same ‘Connect Jira issue’ button on the test execution or test execution details page.

<figure><img src="https://lh7-us.googleusercontent.com/Dc8UsSX9h8slbQ0QDU1l0--TqCiJ8T_SkMBRY82d3bRv4frSaWlZRJulgrHJOVkUvfUf_bichFPh-Ed4G8dCi3I0biHJbg1fpWNBaWHUt3diiCgwhqx5kdpsOdlszAlv1rMF4SXn-DfIhNyzWEV9Ghw" alt=""><figcaption></figcaption></figure>

<figure><img src="https://lh7-us.googleusercontent.com/xxobdPaN1iI8x1_IkLq6TCip0JnSvh0btyK96THSGafgrrh4Ixs4np3WCoxSnsQW5uVu8VOfowRdMANXgk9vnRfSeijTjHNkRgd6vDiIHW4EjFJ6Ep_xNEm_OiPEGj5lv8kEDMeXdvhEileRoROxpQQ" alt=""><figcaption></figcaption></figure>

<br>


---

# 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.aqua-cloud.io/documentation/integrations/jira-link-create-and-or-link-jira-issues-to-aqua-tickets.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.