Skip to main content
Skip table of contents

Сreate Hierarchy

This page provides a step-by-step guide on creating and managing hierarchies



Create Hierarchy from the Manage Hierarchies page

To Create a Hierarchy from the “Manage Hierarchies' page:

  1. Go to Apps Manage Templates → Hierarchies in the navigation bar

  2. Click the ‘Add Hierarchy’ button

Untitled design (3).png
  1. Fill in the required field Hierarchy name and optionally add a Description and Tags.

Untitled design (21).png
  1. Click the ‘Add Node’ button to create your first Root Node.

Untitled design (15).png
  1. For the newly created Root Node, you need to choose the Project in which it will be created, and the appropriate Issue Type.

Untitled design (16).png

Only then you can fill out the Summary and any other required field for its Issue Type of the future issue. To open the Dialog - just click on the Node.

image-20240918-235803.png
  1. Leave the Reporter field empty to set the Reporter field to be equal to any user that’s applying the Hierarchy.  Or you can select the user in the Reporter field to select a fixed user as a reporter when applying the Hierarchy

Untitled design (17).png

The Epic Link field will be set automatically to a parent Epic Node (if any).
If there’s no parent Node of type Epic, a user can associate the node with an existing Epic by specifying it in the Epic Link field.

  1. When the issue is ready, click the Add button to save its state and continue working on creating a Hierarchy.

  2. Click Add Child on the created Root Node to create the nested Child Node. Repeat the steps to populate the Root Node and populate the Issue for the nested Node.

Untitled design (18).png
  1. Create Nodes for all the issues you need, related to this Hierarchy. You can mix different projects and issue types within a single Hierarchy. and finally click the ‘Save Hierarchy’ button to Create Hierarchy

Untitled design (19).png

You can’t Save your Hierarchy until all nodes are validated

image-20240919-001253.png

Generate nodes with AI

To accelerate the process of creating nodes in your hierarchy, you can leverage the Generate Nodes with AI feature. This tool allows you to automatically generate multiple nodes, saving you time and effort.

Steps:

  1. Click the Generate Nodes with AI button

Untitled design (29).png
  1. The AI will create relevant nodes

  2. Review the generated nodes and modify any details if necessary before saving.

Before using the Generate Nodes with AI feature, make sure that AI access is enabled in the Settings section of the app.

  1. Go to the Jira top navigation bar and click on Apps.

  2. Select Manage Apps from the dropdown.

  3. In the left sidebar, scroll down and select Smart Issue Templates.

  4. Navigate to the Settings tab within Smart Issue Templates.

  5. Look for the AI Access section and make sure the toggle is set to Enabled.

Untitled design (30).png

Once enabled, you can use the AI-powered features like generating hierarchy nodes.

Once enabled, you can use the AI-powered features like generating hierarchy nodes.


Hierarchy Variables

To Create Hierarchy Variables:

  1. Click the ‘Variables' button

image-20240919-110521.png
  1. Once the Variables Dialog opens up, click on Add Variable button

image-20240919-110649.png
  1. Select the type of the Variable (TEXT of USER type)

  2. Enter the variable name and add value for the Variable

image-20240919-110808.png
  1. Click the ‘Save’ button

image-20240919-110952.png

Now the Hierarchy Variable was created and can be used in the Hierarchy Node

You can insert these Variables in the Text fields of your Hierarchy and when you Apply it the Variable name will be replaced by the text value.

image-20240919-112302.png

No need to remember all existing variables when you create or update Hierarchies - you can use variables hint. To get all lists of variables print ‘$var’ in the text field and the dropdown will be shown. Click on the variable name you want to add and it will appear in the text field.

Untitled design (22).png

Below the list of fields that support TEXT variable and USER variable usage:

Supported Fields

TEXT Variable

USER Variable

Summary

(tick)

(tick)

Description

(tick)

(tick)

Paragraph

(tick)

(tick)

Environment

(tick)

(tick)

Custom Text Field

(tick)

(tick)

Short Text

(tick)

(tick)

Assignee

(tick)

Reporter

(tick)

People

(tick)


Move Nodes

The Node's order can be easily changed with the Move Out and Move Up/Down actions

Move Out Hierarchy Nodes

With the Move Out function, you can add the Hierarchy Node to a new parent. It`s simple to use because you can move the Hierarchy Node as a child to the new available Hierarchy Node that can be as a parent.

To Move Out Hierarchy Nodes:

  1. Open the Create/Edit Hierarchy page

  2. The Hierarchy Nodes were previously created

  3. Click on the ‘Move out’ button

image-20240919-113328.png
  1. Select the New Parent for the current Hierarchy Node

image-20240919-113454.png

If this Node has a child you can move this Node with a child to a new parent

  1. Click the ‘Move out’ button

image-20240919-113609.png

The value for the issue type field will be cleared after using the ‘Move out' function

But the data in fields for the Hierarchy Node will not be closed

Now the Hierarchy Node was moved out to the new parent and the structure of the Hierarchy was changed.

Move Up/Down Hierarchy Nodes

With the Move Up/Down function, you can easily Move your Hierarchy Nodes and change the order of the Hierarchy Nodes.

To Move Up/Down Hierarchy Nodes:

  1. Open the Create/Edit Hierarchy page

  2. Use arrows to move the Node Up or Down

image-20240919-114014.png

Now the Hierarchy Nodes were moved and the order of the Hierarchy Nodes was changed

Parent Node moves together with all child Nodes connected. Child Nodes can be moved only inside their parent Node.


Duplicate Nodes

To duplicate the existing Node use the Duplicate action

  1. Open the Create/Edit Hierarchy page

  2. Click the ‘Duplicate’ button in the Actions column for the Node that you want to copy

image-20240919-114250.png

The Hierarchy Node was duplicated

Parent Node duplicates together with all child Nodes connected.


Create the Hierarchy Node from the Template

To create the Hierarchy Node from one of the Templates.

  1. Click the ‘More’ menu in the ‘Create/Edit Hierarchy’ screen

  2. Click the ‘Add Node from Template’ button

image-20240919-114611.png
  1. Enter the Template name in the Search field

image-20240919-114651.png
  1. Now the Template was added as a Hierarchy Node

image-20240919-114730.png

Current Smart Issue Templates for the Jira version support only these fields:

  • Summary

  • Description

  • Labels

  • Fix versions

  • Components

  • Assignee

  • Reporter

  • Priority


Save Node from existing Jira Issue

Hierarchy also can be created using the existing Jira Issues. It is possible to add Jira Issue to a new Hierarchy or to existing ones.

  1. Open the Issue which you want to save

  2. Click the Save Node button

c88b0ec1-aefe-4137-8940-d82aba7b0559.png
  1. Select the Hierarchy you want to add this issue as a Node or leave the selector empty to create a new Hierarchy

image-20240919-115306.png
  1. Click the Confirm button

image-20240919-115458.png
  1. Enter the Hierarchy name (if you chose to create a new Hierarchy)

2a6b7ef1-536a-4ec2-9d8a-48e55e1df61b.png

If your Jira Issue has child Issues than they will be added to Hierarchy together

  1. Edit your Hierarchy if it is needed and click the Update Hierarchy button

10177f4c-3afa-4238-a641-4cb9673d9ae0.png

After it, the notification will be shown and Hierarchy will be available on the Manage Hierarchies page.

  1. Click the Actions button in the Save Node section below and select the Remove action to close the Save Node menu.

b7d7d0ee-f5ea-4397-a064-e690146e0bdf.png

In case this section will not be removed, the Create Node From Current Issue dialog will appear every time this page will be opened.


Preinstalled Hierarchies

This feature can simplify workflow by utilizing ready-made Hierarchies, tailored for various departments. Multiple Preinstalled Hierarchies can be created at once.

How to Access Preinstalled Hierarchies:

  1. Open the ‘Manage Hierarchies’ page.

  2. Click the ‘Set Preinstalled’ button.

image-20240919-115934.png
  1. Click on the ‘Departments’ field.

  2. Select any available Hierarchies that need to be created.

image-20240919-120038.png
  1. Click the ‘Create’ button.

image-20240919-120150.png
  1. Now, the Preinstalled Hierarchies was created.

image-20240919-120231.png

 After creating the preinstalled Hierarchies you receive a ready Hierarchy:

First-Time User Note:

For users leveraging the Preinstalled Hierarchies for the first time:

  • A project named 'SITC template project' will be automatically created in your Jira instance.

  • A unique scope labeled 'SITCScope' will be generated.

  • As templates are created, different departments will be categorized as tags, ensuring a structured and organized view.


For any questions or feature requests contact us via Customer Portal

Or drop us an email support@appsdelivered.atlasssian.net. If you are using this option, please check your junk folder regularly, as our reply can be placed there by your email service.

Before submitting a bug report or support ticket, please update to the latest version of the add-on.

Please add information about the version of Jira and the add-on.

JavaScript errors detected

Please note, these errors can depend on your browser setup.

If this problem persists, please contact our support.