• Products
  • Documentation
  • Resources

Link issues to Compass 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.

A Compass component represents a piece of software, like a microservice, library, or application. Together, they make up your software architecture and are cataloged for free in Compass, a developer experience tool.

By grouping issues around Compass components, your team can track and reveal the impact of their work on your software architecture; and surface component information that helps move that work forward. Learn more about Compass components

Anyone can create, view, edit, and delete a Compass component. Once it’s created, anyone in any project can link issues to the component; search for the component across those projects; and track the component’s related work and information from a project’s Components page. Learn how to configure Compass components

Before you begin

Switch to Compass components

A Jira project admin must take these steps in a company-managed project.

  1. In your project sidebar, select Components.

  2. 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.

  1. Open the issue you want to link to a component.

  2. Find and select the Components field.

  3. Search for and select the component you want to link the issue to.

The component will appear in the issue’s Components field, and on the project’s Components page. You can also search for the component in the backlog, boards, and issue navigator.

  1. Open the issue you want to unlink from a component.

  2. Find and select the Components field.

  3. 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.

If the component is grayed out, it means that Compass components are turned off, and your project is using Jira components. You can still remove the Compass component from the issue.


Compass components aren’t yet supported in Jira automation. We’re working on it!

Additional Help