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

Sign up for airfocus or log into your existing account. Create a new workspace in airfocus or select the one you would like to integrate Jira with.

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 new a Jira integration

To do that, simply click on the "Integrations" icon within your workspace 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 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 integration 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 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)

By clicking on "Save and synchronize" you're all set. Congratulations, you've successfully integrated your Jira project with airfocus. 🎉

Additional information

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 👋


Related questions

Have questions? Please get in touch via chat. We reply usually within minutes.

Not yet an airfocus user? Try airfocus for free. Use our powerful yet easy-to-use airfocus scoring system to prioritize & create more effective roadmaps. 🚀

Did this answer your question?