Asana for Jira Server is an integration that allows collaboration and visibility between teams working in Asana and Jira.
This integration brings the value of the Jira Cloud integration to users who use Jira Server.
It allows business and product teams (that spend the majority of their time planning and actioning on work in Asana) to collaborate and track work seamlessly with engineering teams (who plan and execute work in Jira). Its purpose is to optimise scheduling by tracking sprints and ultimately providing Asana users visibility into the development stage in Jira.
Asana for Jira Server bridges the gap between the planning stages in Asana and the development phases in Jira, from execution to delivery.
It creates and monitors the status of Jira issues inside Asana tasks.
Requirements for installation
The Jira Admin must have:
- An Asana account
- Be on a paid plan
- Available for the first steps of installation.
Server or Data Center versions of Jira Software required, and configured according to requirements linked below.
If you use Jira Cloud, use the Asana for Jira Cloud integration
How to install
The Jira Admin needs to create the application link by installing a plug-in file provided by Asana. The Jira Admin will need to complete the first steps, then the end users in Asana will be able to add the integration to any projects they have access to.
Jira Admin Install:
- Navigate to this GitHub repository that hosts install instructions, configuration requirements, and the .jar file for installation
- After configuring your Server instance accordingly, navigate to Administration
- Select Manage Apps
- In the top right corner of the Manage Apps section, click the Upload app link
- Attach the .jar file
- Under User-installed apps, you should now see the enabled Asana app
Next, the Jira Admin needs to authenticate the application by clicking Connect to Asana
- You will be prompted to Auth with Asana
- Once granted please choose the appropriate Asana domain to connect to the new integration
- Once you see a confirmation in Jira, the steps needed from the Server are complete, and the rest can be completed by users in Asana
- In Asana, go to the project you want to add the integration to
- Under project menu, select Add apps and connect to Jira Server (Can also click ‘Customize’ at top left of your project list view)
During authentication if you get the message "Your asana has not been added to Jira server" go back to "Jira Admin Install" step and make sure the Asana Org is authenticated, the relevant workspace has been selected and is showing up in the Jira Server Administration.
Once complete, the app will be added to the project, and users should see a Jira Server field on tasks where they can add existing or create new Jira issues from within Asana.
If this is the first time you have tried to add the App to a project, you will go through a series of Jira and Asana authentication flows. After completion you will be able to link issues to tasks in the relevant project.
The integration can now be used to link an existing Asana task to an existing Jira issue or create a new issue.
Link Asana task to existing Jira issue
From the dropdown menu at the Jira Server field you can add an existing issue.
Then enter the URL of the Jira issue, or simply type in the name of the issue in the text field.
Create Jira issue from Asana task
Select Create new issue from the Jira Server field within the task in Asana.
A new dialog pop up will next appear for you to fill in. Please try and fill in all fields (specifically project and issue type). You can also attach files from the Asana task.
Click Create issue.
Asana will load the relevant details from the completed fields to create the issue.
After you’ve created or linked an issue, you’ll see the updated details about the issue within the task in Asana. You can only add one Jira issue per each Asana task.
Once the Jira Issue is created a real-time Jira widget is available providing you with the Status, Priority, and Assignee of the Jira Issue. Click into it to see more.
Any changes made to the issue in Jira will be reflected in Asana at the next page load.
This integration is optimised to solve two key functions:
Bridge the gap between the planning stage and the hand-off: Project Managers can seamlessly create a Jira issue from Asana when tasks are engineering ready. The planning has already happened in Asana and the product manager is ready to transfer over to the engineering department with ease to do their sprint planning in Jira. This integration saves time and avoids data inconsistencies.
Transparency in development work in Jira: Asana users have visibility to work happening in Jira so they can update stakeholders and important clients on key release dates, bug fixes, etc. Similarly, the product manager wants the flexibility to be able to track, plan, and execute Jira work within Asana. It's a win-win.
Jira Server FAQ
For a list of common questions on the Asana for Jira Server integration, please see our Jira Server FAQ help guide.