Organizing work with components
Managing a project's components
The easiest way to manage a project's components is through the Components page.
- Choose
> Projects, and click the name of the project. - Choose Components in the sidebar. The Components page is displayed, showing a list of components and each component's details. From here, you can manage the project's components as described below.
Adding a new component
- The Add Component form is located at the top of the 'Components' screen.
- 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. 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
- On the 'Components' screen, hover over the relevant component to display the pencil icon.
- Edit the component's Name, Description, Lead, and Default Assignee.
- Click the Update button to save your changes.
Deleting a component
- On the 'Components' screen, hover over the relevant component to display the Delete button.
- You will be prompted to associate these issues with another component if you wish.