Component hierarchy and sub-components

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.

1. In the main Jira navigation menu, click on Apps > Octo Component management.

2. Click on the 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

1. In the main Jira navigation menu, go to Apps > Octo Component management.

2. In Octo click on the Component hierarchy tab.

3. 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.

4. 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.

2. Create sub-components by assigning Parent in component detail

1. In the main Jira navigation menu, go to Apps > Octo Component management.

2. In the Components tab or in the Component hierarchy tab click on the component name in the table to open the component detail.

3. In the component detail, click on the Parent field and select the parent component from the dropdown.

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

1. In the main Jira navigation menu, go to Apps > Octo Component management.

2. In Octo click on the Component hierarchy tab.

3. 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.

2. Assigning label from the component detail

1. In the main Jira navigation menu, go to Apps > Octo Component management.

2. In the Components tab or in the Component hierarchy tab click on the component name in the table to open the component detail.

3. 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.

How to add components to issue using component hierarchy?

1. Open issue detail

2. 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)

3. Click on the Component hierarchy field and select component from the dropdown.

4. Click outside the field to save

The component is now assigned to the issue.