Documentation for JIRA 5.1.x. Documentation for other versions of JIRA is available too.

Components are sub-sections of a project. They are used to group issues within a project into smaller parts.

Note that you can set a Default Assignee for a component. This will override the project's default assignee, for issues in that component.

Managing a project's components

  1. Log in to JIRA as a project administrator.
    (info) A project administrator is someone who has the Administer Project project-specific permission, but not necessarily the JIRA Administrators global permission.
  2. Select Administration > Projects and from the dropdown menu, select the name of the project of interest. Otherwise, choose your project from the Projects list or Project Categories. The Project Summary page is displayed (see Defining a Project).
    (tick) Keyboard shortcut: g + g + start typing project
    The Components section of the Project Summary page shows a summary of components in your project (see Screenshot 1 below).
  3. Click the More link to display the Components page (see Screenshot 2 below), which shows a list of components and each component's details. From here you can manage the project's components as described below.

On this page:


Screenshot 1: The 'Components' section of the Project Summary screen


Screenshot 2: The 'Components' screen

Adding a new component

  1. The 'Add Component' form is located at the top of the 'Components' screen (see Screenshot 2 above).
  2. Enter the Name for the component. Optionally enter a Description and select a Component Lead and Default Assignee (see options below).

Selecting a Default Assignee

You can optionally set a Default Assignee for a component. This will override the project's default assignee, for issues in that component.
(info) If an issue has multiple components, and the default assignees of components clash, the assignee will be set to the default assignee of the component that is first alphabetically.

Default Assignee Option

Description

Notes

Project Default

Issues matching this component will have the assignee set to the same default assignee as the parent project.

 

Project Lead

The assignee will be set to the project leader.

If the project leader is not permitted to be assigned to issues in the permission scheme this option will be disabled and will say "Project Lead is not allowed to be assigned issues".

Component Lead

The assignee will be set to the component leader.

If the component leader is not permitted to be assigned to issues in the permission scheme this option will be disabled and will say "Component Lead is not allowed to be assigned issues". The Component Lead option will also not be available if the component does not have a lead assigned to the component. Instead under this option it will say "Component does not have a lead.".

Unassigned

The assignee of the issue will not be set on the creation of this issue.

This option will only be available if "Allow unassigned issues" is enabled in the General Configuration.

Editing a component's details

  1. On the 'Components' screen (see Screenshot 2 above), hover over the relevant component to display the pencil icon.
  2. This will allow you to edit the component's Name, Description, Lead and Default Assignee.
  3. Click the 'Update' button to save your changes.

Deleting a component

  1. On the 'Components' screen (see Screenshot 2 above), hover over the relevant component to display the 'Delete' button.
  2. You will be prompted to associate these issues with another component if you wish.



See our Getting Help page for details.



Raise an issue for our developers.



See answers from the community.



Tweet, blog and update our documentation.

Except where otherwise noted, content in this space is licensed under a Creative Commons Attribution 2.5 Australia License.