• Products
  • Documentation
  • Resources

Configure Jira components

Jira components can only be configured by project admins in company-managed projects.

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 link issues to 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

Create a Jira component

  1. In your project sidebar, select Components.

  2. Check that Jira components are turned on. Next to Create component, it should say Jira components. If it says Compass components, select it and switch to Jira components.

  3. Select Create component.

  4. Fill out the information for the new component.

    1. Name the component. This is used in an issue’s Components field, or when searching for the component in the project.

    2. Describe the component. This appears next to the component on the Components page, and helps people understand what it represents.

    3. Choose a component lead. This is the person responsible for overseeing work related to the component.

    4. Choose a default assignee. This is the person automatically assigned to new issues that include the component.

      1. The project default is the person who confirms that reported issues are meant for their team, and who re-assigns them accordingly. Learn more about changing the project default assignees

      2. The project lead is the person who controls and manages a project's settings. This person is defined in the project settings. Learn more about changing the project lead

      3. The component lead is the person responsible for overseeing work related to the component. This person is defined in the previous Component lead field.

      4. If the component stays unassigned, new issues that include this component aren’t assigned to anyone.

  5. Select Save.

The new component will appear on the Components page. Anyone in the project can start linking issues to the component, and can search for it in the project backlog, boards, and issue navigator. Learn how to link issues to Jira components

Edit a Jira component

  1. In your project sidebar, select Components.

  2. Find the component you want to edit, and select More actions > Edit.

  3. Change any information you want to edit.

  4. Select Save.

Delete a Jira component

  1. In your project sidebar, select Components.

  2. Find the component you want to delete, and select More actions > Delete.

  3. If there are any issues linked to the component, choose to link those issues to another component, or unlink them entirely.

  4. Select Delete.

Additional Help