# Setup

## Requirements

You need:

* A Jira Cloud account
* An account with Currents Admin permissions
* An account with [Jira Admin](https://www.atlassian.com/software/jira/guides/permissions/overview#what-are-users-and-groups) permissions

## Enable Jira Integration

1. In Currents, navigate to your **Project > Integrations**
2. Click **Jira App > Add Integration**
3. Click **+ Add Jira Installation** (you can have up to 3 installations)
4. Set the Installation label to your Jira namespace (e.g., `currents-dev.atlassian.com`)
5. Copy the **Installation Link Token** - you'll need this to complete the connection

## Install Currents for Jira App

1. Go to [Currents for Jira](https://marketplace.atlassian.com/apps/1238333) on Atlassian Marketplace
2. Click **Get It Now**
3. Follow the installation wizard to complete the installation

## Link Jira App

Connect Jira App to your Currents organization:

1. In Jira, go to **Settings** (upper right) **> Apps**
2. Open **Manage Apps** (`https://<your-domain>.atlassian.net/plugins/servlet/upm`)
3. Find the **User-installed** section
4. Expand **Currents for Jira** and click **Configure**
5. Paste your **Installation Link Token** and click **Link Installation**

{% hint style="warning" %}
**Important:** When you click the **Link** button, the input field will be cleared without any success or error message. This is expected behavior.

To verify the link was successful, return to your **Currents Dashboard > Project > Integrations > Jira App** and confirm the installation appears with the linked status (see example below).
{% endhint %}

<figure><img src="https://3745692499-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FqmFDEiUa9mr11LUlxDnt%2Fuploads%2FaJPIfWiTwwoDjJYKLrs3%2Fcurrents-2025-07-11-15.16.00%402x.png?alt=media&#x26;token=37101266-2a0c-4241-930d-0e956cf46d21" alt="" width="373"><figcaption><p>Link Jira App to your Currents Organization</p></figcaption></figure>

{% hint style="info" %}
Newer versions of Jira moved **App Management** view to **Administration** section. Click **Take Me There**, find **Currents for Jira** > click **"..."** > **Configure.** Enter the link token as appears above.
{% endhint %}

<figure><img src="https://3745692499-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FqmFDEiUa9mr11LUlxDnt%2Fuploads%2FRvdMDOddWnm74LFInToP%2Fcurrents-2025-10-13-21.48.57%402x.png?alt=media&#x26;token=9beda250-6d28-4d22-a3c1-78a50c432ae4" alt=""><figcaption></figcaption></figure>

***

<p align="center">🎉 Congratulations!</p>

<p align="center">When successful, you'll see the linked installation details in your Currents Dashboard:</p>

<figure><img src="https://3745692499-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FqmFDEiUa9mr11LUlxDnt%2Fuploads%2FHLKZXaWYKrCgTqDP3GtJ%2Fcurrents-2025-07-11-15.48.16%402x.png?alt=media&#x26;token=bb43b12e-4edb-41e1-ac4d-d597cbb64c43" alt="Example of successfully linked Currents integration with Jira" width="563"><figcaption><p>Example of successfully linked Currents app for Jira</p></figcaption></figure>