Asana for Jira

Install the Asana for Jira integration to create transparency between business and technical teams and build interactive, connected workflows.

The Asana for Jira integration allows business and product teams that plan work in Asana to collaborate and work seamlessly with engineering and technical teams who execute work in Jira.

Overview

Drive visibility and transparency across Asana and Jira Cloud

• Instead of wasting time with status update meetings and manually updating two different tools, simply connect Asana and Jira to create transparency between business and technical teams.
• Increase visibility into the product development process and reduce unnecessary time wasted on back and forth communication.
• Create interactive, connected workflows between both teams.
• Realize the value and ROI of Jira faster with Asana.

Connect technical and business teams

• Coordinate work across teams to ensure a transparent workflow.
• Ensure a seamless tracking system that works cross-functionally.

Requirements for installation

Asana requirements

The Asana for Jira integration is available to all Asana Premium, Business, and Enterprise customers.

Jira requirements

You must have a Jira Cloud account to install the Asana for Jira integration.

If you use Jira Server, use the Asana Jira Server integration

1. Go to the URL that you use to log in to your Jira account
2. If your URL has this structure: "<your organization name>.atlassian.net", then you're using Jira Cloud, and you’re eligible to use the Asana for Jira integration
3. If your URL does not have this structure: "<your organization name>.atlassian.net", then you're using Jira server and are not eligible to use the Asana for Jira integration

You can find further information on the Atlassian Community page here.

Installation

Via the Customize menu

Navigate to a project where you would like to install the Asana for Jira integration.

1. Click on Customize
2. Go to Apps
3. Select + Add App
4. Select Jira Cloud
5. You'll be prompted by a full screen installation wizard
6. Authorize your Jira account
7. The Jira integration will be installed at project level. Therefore, in the next screen you will be able to select which specific projects to add the integration to.
8. You will be able to use the Jira integration in any of the projects it has been added to.

Via the Asana Apps Directory

1. Go to the Asana Apps Directory
2. Find the Jira Cloud for Asana integration
3. Click on Install Jira Cloud for Asana
4. You will be prompted by a full screen installation wizard
5. At the second step of the wizard, you will be asked to authorize your Jira account
6. The Jira integration will be installed at a project level, so in the next screen you will be able to select what projects you add the integration to
7. You can now go to one of the projects where you installed the Jira integration and start using it

Key Functionality

• Install the Jira application on Asana, then seamlessly link it to as many Asana projects as needed.
• From a task in Asana, users can create a new Jira Issue directly in Asana, or easily link to an existing Jira issue. We support all Jira Software issue types, including: Bug, Epic, Subtask, Story and Task.
• When you create a new Jira issue or link to an existing Jira issue from Asana, we push the following from Asana into Jira: Task name, Description and Attachments.
• To save steps and optimize your workflow, you can automate the creation of Jira issues via our Rules feature. Learn how.

• You can see the real time status of the work happening in Jira from Asana. A real-time Jira widget is available providing you with the Status, Priority, and Assignee of the Jira Issue so everyone is on track.

If you want to see more about the Jira issue, simply click the Jira widget to be routed to Jira to get a more complete overview.

Jira FAQ

How does the authorization model work?

• The integration uses OAuth as the authorization standard. Users will remain authenticated until the OAuth token expires or until someone revokes that token.
• To link existing Jira issues to an Asana task or to create a new Jira issue from Asana you need to authorize into Jira account.

How do permissions work?

• When creating a new Jira issue from Asana, the integration follows Jira’s permission model, so a user can only create a Jira issue if they have permission to do so in Jira. This is the only scenario where a user can write data into Jira (in order to create a new Jira issue). Similarly, this is also the only scenario where the integration reads Asana data.

How does the integration work with Asana?

• The integration reads Asana data, and creates a new Jira issue by writing (optional) some of the Asana task data (task name, description, and attachments) into the new Jira issue’s fields (issue name, etc).

• Similarly, users can only link existing Jira issues to an Asana task if they have authorized their Jira account and have access to those specific Jira issues in Jira.

• Once an issue has been linked to an Asana task, then the read permissions are controlled by Asana’s permissions model. For example, if a user links a Jira issue to task "XYZ", then Asana users with access to Asana task "XYZ" can see (read-only) the linked Jira issue’s data. If you want to keep the Jira data private within Asana, you can make your projects or tasks private.