Set up Compass
Learn how to set up Compass and integrate it with Atlassian products and applications.
Link Jira issues to components
This article refers to features that are currently rolling out. To find out when these features will be live on your site, keep an eye on our release notes or the Atlassian Community.
Link Jira issues to components, so your team can confidently track, prioritize, complete, and reflect on the work on your software architecture.
A component’s Issues page helps in different phases of work:
During backlog grooming or sprint planning, sort issues by priority to decide what to work on next.
During bug bashes, filter issues by type to focus on any bugs that need addressing.
A Jira project’s Components page helps your team track and reveal the impact of work on your software architecture, and surface component information to help move that work forward:
See which components are linked to a project; and see how many issues are linked to each component. This helps you get a sense of how much your team is working on at any given time.
Surface the information surrounding each component – like the owner team, source code repositories, and dependencies – to get more context on and make better decisions about what you’re working on.
Before you begin
Switch to Compass components in Jira
A Jira admin must take these steps in a company-managed project.
In your project sidebar, select Components.
Next to Create component, it should say Compass components. If it says Jira components, select it and switch to Compass components.
You can’t use Compass components and Jira components at the same time. Instead, we recommend using Compass components in Jira, and moving Jira components to custom fields.
Link an issue to a component
Open the issue you want to link to a component.
Find and select the Components field.
Select the component you want to link the issue to.
The component will appear in the issue’s Components field, and on the Jira project’s Components page; and the issue will appear on a component’s Issues page in Compass.
View issues linked to a component
In Compass, find and open the component that you want to view linked issues for.
In the sidebar, select Issues.
In the table, filter issues by type or status, or sort them from the columns. By default, issues are sorted by most recently updated.
Unlink an issue from a component
In Jira, open the issue you want to unlink from a component.
Find and select the Components field.
Select the cross next to the component you want to unlink the issue from.
The component will be removed from the issue’s Components field; and the issue will be removed from the component's Issues page in Compass.
If the component is grayed out, it means that Compass components are turned off, and your Jira project is using Jira components. You can still remove the Compass component from the issue.
Was this helpful?
Still need help?
The Atlassian Community is here for you.