• Products
  • Documentation
  • Resources

Link issues to Jira components

A Jira component represents a section of your project, like a feature, department, or workstream, and are used to group and organize issues in that project. You can automatically assign people to own components, and to issues linked to those components. Learn more about Jira components

Only project administrators can create and configure a Jira component, and they’re only visible to the project they were created in. Once a Jira component has been created, anyone in that project can link issues to it, and search for the component across the project. Learn how to configure Jira components

If you want to create components that represent pieces of your software architecture, switch to Compass components from the project’s Components page.

Compass components are cataloged in Compass, a free developer experience tool. You can add a lot of information to Compass components; and by grouping issues around Compass components, teams can track and reveal the impact of work on their software architecture, and surface relevant information that helps move work forward.

Learn more about Compass components

Before you begin

Switch to Jira 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 Jira components. If it says Compass components, select it and switch to Jira components.

Compass components won’t be deleted, and they’ll still be visible on issues they were previously linked to. You can switch back to Compass 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. You can also search for it in the project 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 Jira components are turned off, and your project is using Compass components. You can still remove the Jira component from the issue.

Additional Help