Occoy

Undelete FAQ

What it keeps, what it can't restore, and how restores behave.

Answers to the questions Jira administrators ask most about Undelete. Not answered here? Email support@occoy.com.

Before you install

Can Undelete restore a work item deleted before I installed it?

No, and no other app can either. Jira keeps no copy of a deleted work item; an app can only restore what it copied before the deletion. Undelete starts protecting your site the moment it is installed. For something already lost, our guide How to restore a deleted work item in Jira Cloud lists what you can still recover (audit log, notification emails, backups).

What does it protect?

Work items in every project you don't exclude: Jira Software, Jira Service Management and Jira Work Management, including epics and sub-tasks. Also comments, worklogs and attachment files deleted from a work item that still exists. Not covered: whole projects (Jira keeps deleted projects in its own trash for 60 days), work items hidden from the app by an issue security level, and Confluence.

How much does it cost?

Undelete is free for sites with up to 10 users. Larger sites get a 30-day free trial, then a per-user subscription billed by Atlassian; the price is on the Marketplace listing. If the subscription ends, deletions are still recorded, but restoring is paused until it is active again.

Where is the data stored? Does anything leave Atlassian?

Everything, including attachment file copies, is stored in Atlassian Forge hosted storage tied to your site. Undelete runs on Atlassian: it has no servers of its own and sends nothing outside Atlassian. Details are in the privacy policy.

Will it slow Jira down?

No. Undelete works in the background on Atlassian's servers, reacting to changes in Jira. Nothing runs in your users' browsers except the Undelete page itself.

Is it a backup tool?

No. It keeps the latest version of every work item so that deletions can be undone. It doesn't keep a history of edits, so it can't undo a change to a work item that still exists, and it doesn't replace a site backup.

After you install

How long until everything is protected?

Work items created or changed after the install are protected immediately. A first scan copies the existing work items and backs up their attachment files in the background; the banner at the top of the Undelete page shows its progress (thousands of work items take minutes). A work item deleted before the scan reached it is still listed, marked "Basic data only".

Do I have to configure anything?

No. The Settings tab lets you exclude projects, change how long deleted items are kept (365 days by default), let project administrators restore their own projects' items, and turn attachment backup or worklog restore off.

Who can see deleted content?

Jira administrators, under Jira Settings → Apps → Undelete - Recycle Bin. If a Jira administrator allows it, project administrators too, for their own projects only (Project settings → Apps). Jira administrators see deleted work items of every project.

Restoring

Why does a restored work item have a new key? How do I find it?

Jira never reuses a key and doesn't let apps choose one, so the restored work item gets the next free key in its project. The Restored tab lists the original key next to the new one. The restored work item also has a comment that starts with "Restored by Undelete from" and the original key, so a Jira search for the old key finds it: text ~ "PROJ-123". Links to the old key (in Confluence, chat or email) don't redirect, so update them if needed.

What exactly comes back?

Summary, description, work type, status, labels, priority, assignee, reporter, components, versions, due date, sprint (if still open), team, custom fields on the create screen, estimates, comments, worklogs, links, epic/parent, sub-tasks, attachment files up to 50 MB and, on Jira Service Management, the request type and comment visibility. Watchers, votes, change history and board rank can't be re-created by any app. The status is restored through as many transitions as the workflow needs (up to 8), along the route the work item itself took when Undelete saw its status change; if it can't be reached, the restore notes say so. When restoring you can untick comments, worklogs, links, attachment files or the sub-tasks deleted with it.

Can I choose what comes back?

Yes. The restore dialog lists comments, worklogs, links, attachment files and the sub-tasks deleted with the work item, all ticked by default (worklogs follow the "Restore worklogs by default" setting). Fields, description and status always come back, with the link to the parent or epic (and, for an epic, to its child work items). What you untick isn't re-created and can't be added later; unticked sub-tasks stay in the recycle bin and can be restored on their own.

Why do restored comments and worklogs show Undelete as their author?

Jira's API doesn't let an app choose the author of a comment or worklog: it always records the app. Posting as each original author would mean acting on their behalf, which needs every one of them to have authorised the app. So each restored comment and worklog starts with a line such as "Originally commented by Alex Morgan on 2026-09-30 14:05 UTC". Time reports count restored worklogs under Undelete; if that matters, untick "Worklogs" in the restore dialog.

What happens to attachments?

Undelete backs up every attachment file up to 50 MB when it is attached (existing files during the first scan) and uploads it again when the work item is restored. Bigger files, and files deleted before their backup finished, can't be restored; their names are listed in the restore comment. Images that were shown inside the text come back as attachments, with a marker where they were.

Will restoring send notifications or run automation rules?

Restores are quiet: the work item is re-created without assignee, its comments, worklogs, files and status are added, and only then are the assignee and reporter (and, on Jira Service Management, the customers) set back, without notification. So the people on the work item aren't emailed for every old comment. Undelete never re-sends @mentions. Jira Automation rules that react to new work items, comments or transitions still run, and if your notification scheme emails others about new work items (a group, the project lead), Jira still does. If the original status doesn't allow any change (some workflows lock their final "Closed" status), the assignee and reporter are set just before the last transition, so Jira may notify them of that step.

What about sub-tasks and epics?

Restoring a parent brings back the sub-tasks deleted with it, under the restored parent. A sub-task can't be restored before its parent: restore the parent instead. If the parent is gone for good, the sub-task is restored as a Task. Deleting an epic leaves its child work items in Jira without a parent; restoring the epic links them to it again.

A restore failed. What now?

The row shows "Restore failed"; click its summary to read the reason. The usual causes: a field that became required after the deletion (make it optional or give it a default value), the project or work type was deleted, or the app may not create work items in that project (its permission scheme must keep the "atlassian-addons-project-access" role). Fix it and click Restore again: nothing is ever created twice.

Can I restore into another project, or undo a restore?

A work item is restored into the project it was in when it was deleted. To undo a restore, delete the restored work item: it goes back into the recycle bin.

Day to day

How long are deleted items kept?

365 days by default; you can choose 7 to 3650 days in Settings. A daily cleanup erases older items for good. You can also erase items at any time with Delete permanently (sub-tasks deleted with a work item go with it).

How do I find out who deleted something?

Every entry shows who deleted it and when, and the Recycle bin tab can be filtered by who deleted. The Who deleted what tab counts deletions per person over 7, 30 or 90 days. Deletions made by an automation rule show the rule's actor. Jira doesn't say who deleted a worklog; Undelete reads it from the work item's history.

Can I export the list of deleted work items?

Yes, as a CSV file for Excel, Google Sheets or Numbers. On the Recycle bin tab set any filters (project, who deleted, days, words) and click Export CSV. The file can hold deleted work items, deleted comments, worklogs and files, and items restored since: who deleted what and when, the new key, who restored it and when. It is made in your browser; Undelete doesn't store it.

Can I see everything one person deleted, or everything deleted last week?

Yes. The Recycle bin tab filters by who deleted and by the days of the deletion, together with the project and search words. The Who deleted what tab counts deletions per person over 7, 30 or 90 days.

How do I stop people from deleting work items in the first place?

In each permission scheme (Jira Settings → Work items → Permission schemes), give the "Delete work items" permission to administrators only. Undelete is the safety net for whoever still has it.

What happens if I uninstall Undelete?

Atlassian deletes everything the app stored for your site: copies, the recycle bin and file backups. Installing it again starts from scratch.

Still stuck?

Read the documentation or email support@occoy.com (Monday to Friday, 9:00 to 18:00 Italian time). Tell us the key of the work item and what you expected.