This feature is not in production yet and will be released on 27th September 2021
If you would like to structure your components to match the real world you can use Component hierarchy in Octo to create sub-components.
Where to find component hierarchy?
You can view the component hierarchy from Octo.
In the main Jira navigation menu, click on Apps > Octo Component management.
Click on the Component hierarchy in the app menu.
Here you can view and edit the component hierarchy.
PICTURE: How to access component hierarchy in Octo to create sub-components in Jira
How to create sub-components?
There are two ways to create a sub-component in Octo. You can either use Component hierarchy to create sub-components by dragging and dropping them over other components. Another option is to assign parent components from the component detail.
1. Create sub-components using drag and drop in the Component hierarchy
PICTURE: How to create Jira sub-components using drag and drop in the Component hierarchy in Octo.
In the main Jira navigation menu, go to Apps > Octo Component management.
In Octo click on the Component hierarchy tab.
You need to have at least two Jira Components to create a sub-component. You can use Create component button to create new Jira components.
Click on one of the components in the list and drag it over the other component and then drop.
The component that was dropped becomes a sub-component, the component that you dropped into becomes the parent component.
If you drag and drop a sub-component outside of any component, then it’ll be in the first level in the hierarchy and its parent will be removed.
2. Create sub-components by assigning Parent in component detail
PICTURE: How to create Jira Sub-component using Parent field in the component detail.
In the main Jira navigation menu, go to Apps > Octo Component management.
In the Components tab or in the Component hierarchy tab click on the component name in the table to open the component detail.
In the component detail, click on the Parent field and select the parent component from the dropdown.
You can’t assign a component as a parent or any of its' sub-components (Childs/components assigned under it) if the component you’re choosing the parent for is already a parent of that component.
You can always visually review component hierarchy in the Component hierarchy tab to better understand relationships between components.
How to use labels to create component hierarchy?
You can tag your components with labels 👉 Learn more about Component labels here. If you’re using labels they’ll also appear in the Component hierarchy tab and dropdowns.
Labels are great if you want to structure your components into groups and you don’t want to use Components to do so. You can also thigh of them like tags. One component can have no labels, one or many.
1. Assigning label by dragging and dropping in the hierarchy
PICTURE: How to assign a component label to the Jira component in the component hierarchy in Octo.
In the main Jira navigation menu, go to Apps > Octo Component management.
In Octo click on the Component hierarchy tab.
Drag component you would like to assign a label to over the label and drop
The component is now assigned to the label and appears under this label in the hierarchy.
If a component has more than one label it will appear under each label in the hierarchy
2. Assigning label from the component detail
PICTURE: How to assign a component label to the Jira component in the component hierarchy in Octo.
In the main Jira navigation menu, go to Apps > Octo Component management.
In the Components tab or in the Component hierarchy tab click on the component name in the table to open the component detail.
In the component detail, click on the Label field and select the existing component label or create a new one.
The component is now assigned to the label and appears under this label in the hierarchy.
Component labels will be always placed on the first level of the hierarchy, there isn’t an option to create sub-labels (yet).
How to add components to issue using component hierarchy?
PICTURE: How to assign a component to an issue using component hierarchy and sub-components in Jira with Octo.
Open issue detail
Open the Component hierarchy field by clicking on the “lego“ icon under issue Summary (you need to do this only once, next time you access the issue field will be visible)
Click on the Component hierarchy field and select component from the dropdown.
Click outside the field to save
The component is now assigned to the issue.
The component hierarchy dropdown isn’t available in the Create issue screen. Unfortunately, Jira apps can’t yet create modules on this screen.