Last updated Nov 21, 2023

Rate this page:

Link Jira issues to components

Efficiently and confidently track, prioritize, and complete the right work on your software architecture by linking Jira Software issues to Compass components.

A Compass component's Jira issues page

Used together, Jira Software and Compass reduce cognitive load for engineers:

  • Clarify technical debt to prioritize during sprint planning.
  • Reveal dependencies that impact sprint completion.
  • Track DevOps health associated with Jira issues.

Once a Jira admin turns on the Compass custom field on a Jira Software site, anybody on that site can start to link work associated with software components in Compass.

Once issues are linked to Compass components, sort and filter those issues from the component’s Issues page in ways that best help your team during different phases of work:

  • During sprint planning or backlog grooming, sort issues by priority to understand what to work on next.
  • During bug bashes, filter issues by type to show bugs that need addressing.
  • During CheckOps, filter issues by their different statuses so you can celebrate or find ways to improve.

Before you begin

Turn on the Compass custom field in Jira Software

A Jira admin needs to turn on the Compass custom field for Jira Software on the same site.

Company-managed projects

  1. In the main navigation, select Settings Settings icon, then Issues.

  2. Under Fields, select Custom fields.

  3. Find the Compass custom field and select More actions More actions icon, then Associate to screens.

  4. Add the custom field to the screens you want by ticking the corresponding box.

  5. Select Update.

The Compass custom field will appear on every issue type in your company-managed project.

Team-managed projects

  1. Select your team-managed project.

  2. From your project's sidebar, select Project settings then Issue types.

  3. Select the issue type you want to edit.

  4. In the Fields sidebar, search for the Compass custom field, and drag it to the list of fields.

The Compass custom field will appear on each issue type you do this for.

  1. Complete the steps in the before you begin section.

  2. Within the same Jira site, find the Jira issue you want to link to a component.

  3. On the Jira issue, select the Compass custom field.

    The Compass custom field within a Jira issue

  4. Choose a component, then select Link.

The Jira issue will be added to the component’s Issues page.

View a component's Jira issues

  1. In Compass, select the component that you want to see Jira issues for.

  2. In the component sidebar, select Issues.

  3. In the table, filter Jira issues by type or status, or sort them from the table columns. By default, Jira issues are sorted by most recently updated.

Edit linked Jira issues

Change the Jira issue linked to a component

  1. Find the Jira issue you want to link to a different component.

  2. On the Jira issue, select the Compass custom field.

  3. Choose a different component, then select Link.

The Jira issue will be added to the new component’s Issues page.

  1. Find the Jira issue you want to unlink from a component.

  2. On the Jira issue, select the Compass custom field.

  3. Select Remove Cross icon, then select OK.

The Jira issue will be removed from the component's Issues page.

Upcoming fix

See the Compass component name instead of the ID when:

  • bulk editing Jira issues that are linked to a Compass component
  • viewing Jira Software advanced search results that include the Compass custom field column
  • viewing Jira Software email notifications that contain the Compass custom field

Rate this page: