Setting up the two-way-integration is easy and should only take a few minutes.
You'll need Jira Administrator Global Permissions to follow the steps below.
1. Login to airfocus
Note that you have to authorize your Jira instance only once per airfocus team.
You can add multiple Jira integrations to a given workspace (e.g. from different Jira projects or instances).
2. Setup a new Jira integration
To do that, simply go to the App section within your workspace, click on "Explore integrations" and connect with Jira.
Select "Connect to a new Jira instance", enter your Jira instance URL (e.g. https://airfocustest.atlassian.net/) and click on "Proceed".
Follow the directions of the Authorization Guide to authorize the application linking between Jira and airfocus.
3. Configure integration filtering
Decide which Jira project and issue types you want to import or sync. For issue types, use JQL to specify criteria for which issues to load (read more about JQL here).
Example: If you just want to import/sync Jira epics and stories with a To Do status, simply use this command: issuetype in (Epic, Story) AND status = "To Do"
4. Configure field mapping
Use mapping to define how information in Jira should be mapped to information in airfocus. If you change an issue or item in one system, the other system will be adjusted accordingly.
You can define how Jira statuses should be mapped to airfocus lanes and/or how Jira labels should be mapped to airfocus labels. You can also map multiple Jira statuses to one airfocus lane.
Furthermore, you can define which Jira label you want to attach to a Jira issue that is synchronized with airfocus.
Another option is to map your Jira start and due dates to the airfocus timeline.
Find more information about that here.
You can also map the airfocus focus score to a custom field on your Jira issue card. Find more information here.
5. Configure custom field mapping
With our additional custom field mapping, it's possible to map and synchronize custom fields that you might have in the integration Jira project with the custom fields in your airfocus workspace.
You can find more information on our custom field mapping and how to set it up here.
6. Configure additional options
With two-way sync, the changes that you make in Jira will be reflected in your airfocus workspace and vice versa, saving you time and keeping your team organized. In case of conflicts (e.g. a simultaneous title change in Jira and airfocus), we will always use the data from Jira as the leading system.
When "Archive unknown issues" is enabled, then previously imported items will be archived in airfocus, if they are not present in Jira anymore (or just do not match the JQL filter anymore).
To connect another Jira project from the same Jira instance with your workspace, you don't have to go through the authentication process again. You only have to link (and authenticate) your Jira instance with your airfocus team once.
Looking for static IP's to white-list for your Jira Server integration? Click here 👋
Have questions? Please get in touch via chat. We reply usually within minutes.
The first modular product management platform: Discover, learn, plan and deliver - your way.
Not yet an airfocus user? Start your free trial today and join thousands of teams who use our flexible (product management) platform to build products that matter.