# Components - How to use Jira

'define expected-reading 2 min
'define created 24 July 2020
'define edited 03 June 2021
[$pagenav]

'define start_link ./
'define prev_link ./pages.html Pages
'define next_link ./dashboards.html Dashboards
[$pagination_middle]

.contents
.numbered
1. [url #creating-and-editing Creating and editing]
2. [url #adding-issues Adding issues]

Components are =[yet another way to group issues together]=. They don't have any specific meaning like versions, their usage depends on the project's organisation.

## Creating and editing

Creating and editing them is done from the =[`[Components]` menu in the sidebar]=.

[image ./img/components-sidebar.png]

Creating one is done through the button on the top right (in the center if you don't have any components) by the name of `[Create component]`.

[image ./img/create-component-empty.png]

[image ./img/create-component-full.png]

Clicking on it presents you with a screen where you input it's information.

[image ./img/create-component-page.png]

=[A name is the only requirement]=. You can also add a =[description]=, =[a lead(er) for the component]= and =[person who gets assigned to an issue by default]=.

## Adding issues

Adding an issue to a component can be done either =[when creating it]= or =[when viewing it]=.

=[Right under the summary]=, there is a place for indicating a component, named `[Components]`.

[image ./img/components-create-card.png]

When viewing an issue, you can add one from the `[Components]` field to the right (you might need to first click on `[Show more fields]`).

[image ./img/show-fields.png]

[image ./img/components-field.png]