In order for a team’s planning to flow smoothly into communicating outwardly on the progress of their work, we acknowledged that integrated experiences need to exist between Atlas and Jira. That’s why we built Atlas for Jira Cloud, a free app available on the Atlassian Marketplace.

⚠️ Atlas for Jira Cloud currently only supports Jira Software Cloud. We are exploring supporting additional Jira products like Jira Work Management, Jira Service Management, and Jira Product Discovery.

What’s the difference between Atlas and Jira?

We built Atlas to aid team-to-team communication while Jira is designed for communicating within your direct team. This is because the level of detail required when communicating to each of those audiences is very different. To learn more about how we perceive the relationship between Atlas and Jira, check out this article.

⤵️ Jump ahead:

How to install the Atlas for Jira Cloud app

The app needs to be installed from the Atlassian Marketplace by a site admin of your Jira Cloud instance. Once installed, a new field will appear on epics in company-managed or team-managed projects.

⚠️ We recognize customers have different hierarchy models in their organizations and may want to map an Atlas project to a different issue type. We are currently exploring the ability to allow this.

How to use Atlas for Jira Cloud

Connect to Jira Cloud from Atlas

When you add a link to a Jira Software epic under Where are we tracking the work? on an Atlas project, you'll be prompted to sync that project with the epic.

If you dismiss the banner, you'll still be able to sync with Jira later by clicking the pencil icon next to your Jira epic link and hitting the Sync with Jira Software button.

Connect to Atlas from Jira Cloud

From your Jira Software epic, click into the Share updates on this work field to link or create a new Atlas project in an Atlas workspace you have access to.

There is a 1:1 mapping between an Atlas project and a Jira Software epic. If you’d like to add more links to your Atlas project without syncing them, we recommend using the Related Links field.

Syncing a Jira epic with an Atlas project

When you link an Atlas project to a Jira Software epic, you’ll be asked to confirm which details you’d like to sync initially from either Atlas or Jira:

  • title

  • target dates

  • tags

Once linked these details will be kept in sync between your Atlas project and Jira Software epic and in your Atlas project you will see the Jira Software epic name and status appear under the Where is the work tracked? field.

The app syncs target dates to Jira’s system fields, which can be used in roadmaps. It also adds two custom fields to your Jira Software Cloud instance, which can be used for additional reporting:

  1. Atlas project key

  2. Atlas project status

If a date is changed in either Jira or Atlas, Atlas will provide that context in the relevant project update.

View Atlas project details in Jira epics

From your Jira Software epic in the Share updates about this work field, you'll see the connected Atlas project’s name, status, latest update, and overview.

Show stakeholders where your team tracks the work

Your Atlas project can serve as a hub for any stakeholder to dive into related information and finer details of the project. Simply add links to where your team is doing the actual work under Where are we tracking the work? and with the power of smart links, we'll render that with meaningful information that a stakeholder could easily click through.

Share context between Atlas and Jira with Smart Links

Pasting links between Atlas and Jira Cloud will render context-rich links which you can display in-line or as embeds. To read more about how to use embed smart links, check out this article.

If you’re interested in learning more about how we perceive the relationship between Atlas and Jira, read this article next.

Did this answer your question?