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.
- During CheckOps, sort issues by status to celebrate progress or find ways to improve.
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.
Jira components won’t be deleted, and they’ll still be visible on issues they were previously linked to. You can switch back to Jira components at any time.
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.
Rate this page: