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.

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 Jira 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

Company-managed projects

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

2. Under Fields, select Custom fields.

3. Find the Compass custom field and select More actions , 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.

Link and view Jira issues

Link a Jira issue to a component

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.

   

4. Choose a component, then select Link.

The Jira issue will appear on the component’s Jira 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 Jira 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 appear on the new component’s Jira issues page.

Unlink a Jira issue from a component

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 , then select OK.

The Jira issue will disappear from the Compass component's Jira issues page.

Upcoming fixes

• Link Jira issues to Compass components on different Jira sites.
• 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