Release Notes

Versions in Cloud?

Even though Hierarchy for Jira is a Cloud app, it still has versions. You don't need to do anything for minor updates; these are served to you automatically.  But, when there is a major update, you need to take action to get all the new features and improvements. See this page for more information on how to update to the latest version of Hierarchy for Jira.

Here are the changes we document in the Release Notes:

  • New Features - Brand new functionality designed to make Hierarchy for Jira exceptional.
  • Updates - Changes we’ve made, large and small, that we want you to be aware of.
  • Bug Fixes - Issues we’ve resolved to make the app work as intended.

Version 9.1 - 11th July 2023


  • Minor update

Version 9.0 - 11th July 2023

Bug Fixes

  • Fixed a bug where some users saw an error about unexpected end of JSON input. 

Version 8.7 - 11th July 2023


  • Added a banner to alert users to the upcoming new version requiring an update.

Version 8.6 - 22nd June 2023


  • Added the ability to edit the name of a saved view from the Manage Saved Views menu.

Bug Fix

  • Fixed an issue where hierarchy would fail to build

Version 8.5 - 31st May 2023


  • Minor update to in-app copy to improve the user experience.

Version 8.4 - 25th May 2023

New Features

  • You can now save your preferred settings and filters into different saved views. This makes it possible to create specific views to share with different stakeholders or to jump from one view to another without going into the settings each time.

Version 8.3 - 24th April 2023

Bug Fix

  • Fixed an issue where projects and filters with the & symbol in their name were not loading

Version 8.2 - 17th April 2023


  • Increased the number of projects and filters that are supported in the app. Users with more than 50 projects or 500 filters will now be able to see all of their projects and filters.

Version 8.1 - 28th March 2023

Users who have not migrated to the new Forge version of the app will be asked to do so with this release.

New Features


  • The columns have been updated in the table view. Now you can
    • Add any progress column fields.
    • Have both Story Point and time tracking progress columns, or neither!
    • Reorder progress columns.

Bug Fix

  • Fixed an issue that affected users in Firefox; When the text in the summary field was shortened to fit the cell, the word ellipsis would appear.

Version 8.0 - 14th March 2023

To get the features for this release, you need to update manually. In Jira, navigate to Manage Apps and select Update.

New Features

  • A new quick filters feature has been added. This lets you define your most used filters and turn them into buttons on the homepage for easy use. 


  • We've removed the issue glance module. This feature wasn't being used, and your feedback suggested it was just confusing so we've removed it from the app.
  • We've added a new spotlight tour for first-time users. Users will be given a quick tour of the main features of Hierarchy for Jira to help them get started with the app.

Version 7.1 - 28th February 2023


  • UI updates have been made to the table view to simplify the interface and ease navigation. 
  • Improvements have been made to the column feature. Multiple Columns can be added from the same menu.
  •  The remove columns button is now easier to find.

Version 7.0 - 19 January 2023

To get the features for this release, you need to update manually. In Jira, navigate to Manage Apps and select Update.


  • The Creating Custom Issue Hierarchies topic has been updated and improved to reflect changes to the app's UI and improve the onboarding experience for new users. 
  • A Get Started button, which opens the Hierarchy for Jira user documentation, has been added to Jira's User-Installed Apps section. This button is only available to Jira admins who downloaded and installed the app.

21 December 2022


  • A Collapse/Expand option has been added to the Hierarchy Tree view. Click to collapse all issues to the top level, and click again to expand all issues. 
  • The No Issue Link Type option has been added to the Issue Link Type drop-down list for Active Hierarchy. Select No Issue Link Type to only show the default issue hierarchy in the Hierarchy Tree view. This update ensures that:
    • The app loads as usual even when the Issue Linking feature is disabled in Jira, which previously caused the app to break.

    • For new app users, this is the default issue hierarchy until a different issue link type is selected for Active Hierarchy.

Bug Fixes

  • Fixed an issue that caused changes to the Saved Filter not to be reflected in Hierarchy for Jira. This issue required users to reload the table with a different filter and reopen the previous one to update it properly. Not fun!

    Thanks for the suggestion!  💡

    We fixed this issue because you, our users, requested it on the Hierarchy for Jira Nolt board.

    Visit the board to suggest your own ideas for new features and app improvements, and vote for the best ideas you see. We're listening! 

14 November 2022


  • We made the filter name persist throughout the app experience. Now when you open Hierarchy for Jira filter or when the page is refreshed, the name of the filter in use consistently displays in the Select project or filter field. 
  • We made the Hierarchy Tree view responsive to your screen resolution to improve the app experience for those using large monitors. 

    Thanks for the suggestion!  💡

    We made this update because you, our users, requested it on the Hierarchy for Jira Nolt board.

    Visit the board to suggest your own ideas for new features and app improvements, and vote for the best ideas you see. We're listening! 

Bug Fixes

  • Fixed an issue that caused custom-issue icons to display incorrectly in the Hierarchy Tree view for some project types.
  • Fixed an issue that caused menu items to collapse and display incorrectly when the JQL editor was in use.

02 November 2022

Bug Fixes

  • Fixed an issue that prevented the Hierarchy Tree view from loading properly (infinite loop) when users made a child issue the parent of its parent.

12 October 2022

New Features

The Active Hierarchy dropdown was improved and moved to a more useful place within the app to give you the ability to customize the way your issues display in the app's Hierarchy Tree view. Now you can opt to filter the view by specific link types in order to see issues linked in ways other than Jira's default hierarchy view.

Click Active Hierarchy to browse the filter options via the dropdown list as well as the show/hide options for Jira's default hierarchy view. The link types that appear in the drop-down list reflect those that exist in your instance. And with this release, existing Hierarchy for Jira Cloud users can rename the previously configured "Agile Docs Parent" link to any preferred name that better suits their needs.

How filtering used to work

Previous to this feature release, the Hierarchy Tree view only allowed users to view Jira's default hierarchy (Epics > Stories > Subtasks) or the Agile Docs Parent view, which is a custom link type that displays both parent-child linkages as well as Jira's default hierarchy. This new feature allows users to hide the default hierarchy from the Hierarchy Tree view.

The new hierarchy filtering option is also available at the issue level in the progress summary detail.


  • Links to helpful resources have been added to a Help dropdown.

    Links contained in the dropdown list include the following:
    • Getting started
    • Contact support
    • Suggest a feature
    • Write a review

13 September 2022


  • A supplemental video demonstration has been added to Creating Custom Issue Hierarchies. Same info, different format. 
  • We improved the text search so that returned search results are highlighted. Parent and child issues are also visible in search results, explained as follows.

    For example, if you search for a top-level issue, the search results display all existing child issues, e.g., PE-20 and PE-21 below:

    If you search for a child issue, the search results include the issue's parent as well as the parent's parent:

    Sibling issues

    If a search key returns an issue at the lowest child level, e.g., PE-21 in the image above, the search results only display parent and child issues, not sibling issues (other same-level child issues that share the same parent).

Bug Fixes

  • Fixed an issue that caused board issues to sort and display inconsistently while using predefined filters versus the issue display of an equivalent JQL query. 

30 August 2022

New Features

New time unit  📅

The week time unit has been added to the app for improved progress feedback and clearer estimations. 
Note: One week is equal to five workdays (1w = 5d).

Original Estimate Progress: Improvements for estimations and reports  💪

You now have the ability to track progress against original effort estimates.
Access the new option in the Settings menu by clicking 

There are a few reasons we added this feature, all of which relate to limitations within native Jira tracking and reporting. For example:

  • In Jira, reports are only available for specific scrum boards, making it impossible to track progress outside of sprint.
  • Native Jira progress tracking does not communicate whether completed sprint work is under- or over-committed.
  • Measuring your team's actual capacity is difficult in Jira because efforts that fail to exactly match original estimate values aren't taken into consideration in regard to actual sprint work. Valuable information like time spent and remaining estimates can be beneficial to spotting potential delays and making accurate projections of completion dates.

With the new time-tracking perspective of Original Estimate Progress, you can easily evaluate and compare your project's sprint-completion numbers to the original estimates, which allows you to more accurately gauge velocity and fine-tune adjustments for subsequent sprints.

See Monitor Progress to learn how to use the Hierarchy for Jira's Original Estimate Progress and Current Estimate Progress to improve your estimations and reports. 


  • We changed the Status Category column header to Status. 

18 July 2022

New Features

Brand new look and feel  🕶️

Hierarchy for Jira just got a major makeover! There are so many new things to show you!
Not only does the app look better, but it's more customizable and more eloquently nested within Jira, which allows it to work much faster than the previous version.

Search with JQL  🔎

JQL (Jira Query Language) search is now available! Use Atlassian's handy range of fields, operators, and values to customize your search results like never before. Once you’ve entered a JQL query (or selected a filter), the app returns all of the issues in a nested tree view.

In addition to JQL search, basic project and filter searches are also available. Toggle between the two options by clicking Switch to JQL and Switch to Basic.

This update to Hierarchy for Jira changes the way filters display issues. If your filters only includes issues at the top level, you need to edit the filter to include ALL issues in your hierarchy. The previous version of the app displayed children issues automatically, but the latest version of the app applies filter logic more strictly.

To make sure the tree view works as intended, we’d recommend refining the JQL filter to query all issues and their subordinate issues, such as this: parentEpic in (AP-9,AP-7,AP-123)

Please note! ⚠️

Hierarchy custom fields cannot be used in JQL searches at this time. 

Search with text  🕵️

Text search for key and summary details is also now available! Returned items populate in the table view and include the parent issue.

New sum option for issue estimates  🔥

Now there's a new way to view and measure your project efforts called Sum-up values.
From the table view, click the Settings cog to select your estimation preferences. 

The new option, Sum-up, is the total value of child-issue estimates (story points or time) INCLUDING parent estimates.

To illustrate the differences between the two estimate options, see the following examples:

  • Roll-up value
    If a parent issue has no story-point value assigned, Hierarchy for Jira totals the story points from all of the child issues directly below it and adds that total number of story points to the parent issue. If a parent issue has an assigned story-point value, Hierarchy for Jira takes no action.

  • Sum-up value 
    The story-point sum for parent and child issues, which appears on the parent issue.

The impact of filters

Roll-up and Sum-up values, for both story-point and time estimates, are calculated based on view parameters. If a filter is applied to hide issues, those filtered/hidden issues are not included in Roll- or Sum-up values.

Use table context to create JQL filters  👀

There's a new Scope option at the footer of the table view that, when you hover over it, shows you the current view's JQL query.

Click Scope to copy the query to your clipboard. With the query copied, you can navigate to the Filters section and create a new filter just by pasting the query, naming it, and then saving the new filter.

All issues in your hierarchy must now be included in your filter 💡

In the previous version of Hierarchy for Jira, your filter only needed to include the issues at the top level, and the app would retrieve and display all children issues. In this new version of the app, all issues in your hierarchy must be included in your filter.


  • Super speed! ⚡ Hierarchy for Jira works faster than ever—no more long waits for loading screens!
  • You can now edit issue details within Jira—no more clunky new tabs to deal with. Simply click an issue-key link, and edit within Jira, just as you'd expect.

    Don't forget to refresh!  🔄

    Any changes made to an issue from the issue view will not display in the table until you click Refresh, either above the table or in the table footer.

    Refresh above the table:

    Refresh in the footer:

  • Edit the Summary field directly from the table view by double-clicking the existing summary. Press Enter or click outside of the cell to save the new summary. 

  • Using the new UI, you can customize columns to track only the information you need and nothing else.
    Simply click the add icon to the right of the column headers, then select new columns to add one at a time. 

    To remove a column, hover over a column name and click the small x.

    Column limitations

    Some columns, by default, are permanent and cannot be removed. Also, columns cannot be reordered at this time.

  • Viewing options for Hierarchy custom fields have changed.  👀
    Previously, custom fields could be viewed directly on the issue details view. In this new version, you need to click Click to view on Progress summary to expand the custom fields section.

    JQL limitations

    The Hierarchy for Jira custom fields cannot be used in JQL queries at this time.

On this page