Come for the products,
stay for the community

The Atlassian Community can help you and your team get more value out of Atlassian products and practices.

Atlassian Community about banner
Community Members
Community Events
Community Groups

Managing Jira Deleted Issues

The Jira Deleted Issues Report is used to view Jira Align work items linked to Jira Software Issues for which Jira Align can no longer access via the API.

Typically there are two conditions that cause items to show up in the Deleted Issues Report:

1) Jira Issues linked to Jira Align items have been permanently deleted by a user in Jira Software.

2) Jira Issues that had their parent project's permissions changed so that the Jira Software Connector Service Account no longer has permissions to view the issue.

The report will display the Jira Software Key, the type of Jira Align work item (as an icon) and its ID, and the work item’s name in Jira Align. 

Note: The Jira Deleted Issue Report transmits a large amount of API Calls between Jira Align and your Jira Software environment. It is highly recommended to run this report once a week, and schedule the run during non-working hours to prevent any interruptions to the regular sync of data.

To manage Jira deleted issues:

  1. Open the Jira Deleted Issues tab.
  2. Select a date and time to run the check. To run the report as soon as possible, enter the current date and next upcoming hour. For example, if it is 3:30PM, schedule the report to run at 4PM. The hour you choose to run the report will be in the Time Zone selected in your personal preferences. 
  3. Click the Check for deleted Issues button.
  4. After the report query has been completed, set Hierarchy and PI Filters in the context menu or locally on the page to parse data. Selections made on the page will override the Configuration bar once the Filter button is selected.
  5. Click the Error Types Field and Filter on Only 'Issue does not exist'
  6. View the report:
    • Click the link under the Jira Key column to view the item in Jira. It may still exist but have a new name.
    • Click the link under the ID column to view the item in Jira Align.
  7. Toggle-on the sliders to the right of each item you want to delete, remove the Jira Software key from, or ignore.
  8. On the toolbar, select one of the following options:
    • Delete. Remove all selected items from Jira Align.
    • Remove Jira Key. Delete the Jira Software keys associated with the selected Jira Align work items. This will keep the Jira Align items and disconnect the Jira Software issue from them.
    • Ignore. Remove all selected Jira Align work items from this report. This will keep the item in Jira Align and leave the Jira Software keys connected to the item. Ignored items may appear again in a future report if the items are still not found in the future.
  9. Alternatively, select one of the Delete All, Ignore All, or Remove Jira Key All options to affect all items returned by the report. Note that these options will delete, ignore, or remove the Jira key from all items found by the report, including those not visible on the current page of results.

Note:   Issues displayed with a red warning indicate that the Jira Parent Project Permissions changed or the issue was deleted in Jira Software. The report also displays API parsing errors via a yellow icon; the parsing errors should be ignored or filtered out using the Error Types, as the issues still exist in Jira Software.

Note:  In current versions of Jira Align, the report no longer searches for accepted stories and features, as well as closed defects. 


Great write up @Kent Baxley ! Much needed in the Community!

Like # people like this

Great Article! Thanks for the guidance! Perhaps including that the Jira Deleted Issues tab can be found under Administration → Connectors → Jira Management would be helpful as well! Just a suggestion.

Like # people like this

2 years later, this is still a super valuable article! 


Log in or Sign up to comment
Community showcase
Published in Jira Align

Rockin' the Roadmap - How to make most of the Roadmap with Jira Align

The roadmap challenge for large scale agile enterprises Regardless of the agile framework you use, the agile enterprise has a massive scale with the challenge to connect hundreds of teams and thous...

2,446 views 7 24
Read article

Community Events

Connect with like-minded Atlassian users at free events near you!

Find an event

Connect with like-minded Atlassian users at free events near you!

Unfortunately there are no Community Events near you at the moment.

Host an event

You're one step closer to meeting fellow Atlassian users at your local event. Learn more about Community Events

Events near you