Child pages
  • Viewing History of a Structure

This documentation relates to an older version 1.7 of the Structure Plugin for JIRA. View the current documentation home.

Skip to end of metadata
Go to start of metadata

Structure plugin records every change that you or other users make to a structure. The History View lets you see those changes and previous versions of your structures.

To turn on the History View, click the clock button on the toolbar. The list of recorded changes appears to the left of the structure grid, and the most recent change is selected.


Structure History has been introduced in Structure version 1.4. All changes made with earlier versions of Structure plugin have not been recorded.

Reading History View

By default, 20 most recent changes are loaded. If there are more, you can click the Show More button at the bottom of the list to load earlier changes. Newer changes are loaded and added to the top of the list as they happen.

For each change, the following information is shown:

  • The avatar and the name of the user who has made the change. In JIRA 4.4 and up you can hover your mouse over the user avatar to see the user details.
    • If the change has been made by a synchronizer, the synchronizer's name is shown. User avatar displays the user account that the synchronizer was running under.
  • The nature of the change – how many issues were affected, were they added, removed or moved.
  • The date and time when the change was made.

When you click a particular change, the main panel of the widget shows the structure as it was when that change was made. The affected issues are highlighted, and the structure expands and scrolls as needed to bring them into view.

Use the Ctrl+] and Ctrl+[ keyboard shortcuts to navigate to an earlier or later change.

If issues were removed, they are shown in their position before the removal. Moved issues are shown in their new position by default, and their original position is marked by a red horizontal line. Use the small toggle button in the history section to show moved issues in their original position instead.

Limitations of the History View

History view is a powerful tool to track the history of a structure, however, it does not allow to change the history or to see the values of the issue fields as they were in the past. More specifically:

  • All columns with issue fields (Summary, Description, Status and others) show current values – not the values that the issue had when the structure change was made.
  • Aggregation columns, such as Progress or Total Time Spent do not show any values.
  • You cannot edit issues, create new issues or change structure when viewing history.
  • The history cannot be modified. (The administrator is able to clear whole Structure history.)

Printing a Previous Structure Version

You can Open Printable Page when viewing a previous version of the structure. The printable page will show the structure as it was after the selected change has been applied.

Note that all limitations apply: the current values of the fields will be displayed and Progress and other aggregate columns will not be displayed.

Exporting a Previous Structure Version to XLS Format

Like with the printable page, you can export structure to XLS (Excel). The XLS file will contain structure as it was after the selected change has been applied.