Documentation for JIRA 5.0. 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. Login to JIRA as a project administrator. (A project administrator is someone who has the project-specific permission 'Administer Project', but not necessarily the global permission 'JIRA Administrators'.)
  2. Click the 'Administration' link at the top of the screen.
  3. Click 'Projects' and select the project of interest.
    (tick) Keyboard shortcut: 'g' + 'g' + start typing 'project'
  4. You will now see the 'Project Summary' screen (see Defining a Project). On the lower right, a summary of the components is displayed (see Screenshot 1 below).
  5. Click 'More' to display the 'Components' screen (see Screenshot 2 below), which shows a list of components. 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.