Component hierarchy and sub-components
- Nikki Zavadska
- Michelle Ruoff
- Ben Hill (Deactivated)
If you would like to structure your components to match the real world, you can use the component hierarchy in Octo to create sub-components.
Where to find the component hierarchy
You can view the component hierarchy from Octo.
In the main Jira navigation menu, navigate to Apps > Octo Component management.
Click Component hierarchy in the app menu.
Here you can view and edit the component hierarchy.
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
In the main Jira navigation menu, navigate to Apps > Octo Component management.
Click the Component hierarchy tab.
You need to have at least two Jira Components to create a sub-component. Click Create component to create new Jira components.
Click 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
In the main Jira navigation menu, navigate to Apps > Octo Component management.
In the Components tab or in the Component hierarchy tab click the component name in the table to open the component detail.
In the component detail, click the Parent field and select the parent component from the drop-down.
You can’t assign a component as a parent or any of its sub-components (child/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 drop-downs.
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 think of them like tags. One component can have no labels, one, or many.
1. Assigning label by dragging and dropping in the hierarchy
In the main Jira navigation menu, navigate to Apps > Octo Component management.
Click 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
In the main Jira navigation menu, navigate 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 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.
How to add components to issue using component hierarchy?
Open the Jira issue and click the component button above the Description field. (you need to do this only once, next time you access the issue field will be visible)
Click the Component hierarchy field and select the component from the drop-down.
Click outside the field to save.
The component is now assigned to the issue.
The component hierarchy drop-down isn’t available in the Create issue screen. Unfortunately, Jira apps can’t yet create modules on this screen.