YouTrack Cloud 2024.1 Help

Delete Issues

Deleting issues in YouTrack is not to be taken lightly. Each issue has the potential to contain a wealth of information that, when lost, cannot be recovered easily. In general, we recommend that you avoid deleting issues whenever possible. Here are a few alternatives to deleting issues:

  • If the issue duplicates an existing issue, link it to the existing issue as a duplicate. In this case, the value for the State field is set to Duplicate, which is a resolved state. The issue is excluded from search results for unresolved issues, but any information contained in the issue is retained.

  • If the issue is no longer relevant and you don't want anyone to waste time working on it, select an appropriate value for the State field to resolve the issue. Default states like Can't Reproduce, Won't fix, Incomplete, and Obsolete indicate that the issue does not require additional effort. This helps to explain why an issue should not be fixed without deleting it from the system.

  • If you created an issue in the wrong project, don't delete it and create another. Simply update the value in the Project field.

The best reason that you might have for deleting an issue is because you created it by mistake. If you're confident that an issue that you created is unnecessary, you should be able to delete it without disrupting anyone else's work. Just don't assume that this rule applies to issues that were created by other users.

To delete a single issue:

  1. Open an issue in quick view or single issue view.

  2. Click the Show more option in the issue toolbar.

  3. Select the Delete issue option from the menu.

    Delete issue
  4. Click the Delete button in the dialog to confirm the action.

    • The issue is deleted from YouTrack.

    • The action cannot be undone.

    • To restore the issue, you have to restore a backup copy that contains the issue and import the issue from the backup to your YouTrack database. For more information, see Restoring Deleted Issues.

To delete a single issue:

  1. Open an issue in single issue view.

  2. Click the Show more button in the toolbar and select Delete issue.

    Delete issue
  3. Click the Delete button in the dialog to confirm the action.

    • The issue is deleted from YouTrack.

    • The action cannot be undone.

    • To restore the issue, you have to restore a backup copy that contains the issue and import the issue from the backup to your YouTrack database. For more information, see Restoring Deleted Issues.

You also have the ability to delete multiple issues at once with commands. You should be very careful when performing this action, as you can select more issues than can be displayed on the Issues list and delete them in one go. Proceed with caution!

To delete multiple issues:

  1. Select one or more issues in the Issues list.

  2. Click the Delete issues button in the toolbar.

    • A confirmation dialog opens.

    Confirmation dialog for deleting multiple issues.
  3. Click the Delete button to confirm this action.

    • The issues are deleted from YouTrack.

    • The action cannot be undone.

    • To restore these issues, you have to restore a backup copy that contains the issues and import them from the backup to your YouTrack database. For more information, see Restoring Deleted Issues.

You can also perform this action by applying the delete command to a batch of issues.

Command to delete multiple issues.

To learn more about updating batches of issues with commands, see Apply Commands to Issues.

Restoring Deleted Issues

Administrators can restore recently deleted issues from a dedicated page in the Administration section of the application. The Deleted Items page displays all recently deleted items that have the option of being restored. For more information, see Deleted Items.

Deleted issues are only available for a short period of time before YouTrack's automated housekeeping permanently removes them. Once an issue has been deleted permanently, it can only be restored from a database backup.

To ask that one or more deleted issues be restored to your YouTrack Cloud instance, submit a support request. We'll do our best to locate the issues and restore them to your instance. However, we cannot guarantee that the restored issues contain all the data that was lost. There may be updates that were applied after the backup was created that cannot be recovered.

Deleting Issues Permanently

Issues that are deleted from YouTrack are preserved in the database for a short period of time. This makes it possible to restore them if they were deleted by mistake. If you want to delete a batch of issues, you can delete them permanently and reduce the size of your database. Administrators can permanently delete recently deleted issues from the Deleted Items list. For specific instructions, see Deleted Items.

Another way to delete issues permanently is to delete the project they belong to from YouTrack. This action is mostly used to get rid of old projects you no longer use. For instructions, see Delete a Project.

If you want to delete older issues while keeping the project open, use this workaround:

  1. Create a new project.

  2. Use a search query that returns all the issues that you want to delete. For example, search for issues in your project that were resolved six months ago or earlier.

  3. Use a command to move all of these issues to the new project. For example, move to <new project name>.

  4. Remove the new project from YouTrack.

Restricting Delete Issue Permissions

In many issue trackers, the ability to delete issues is restricted to system and project administrators. In YouTrack, this permission is granted to the default Contributor role. This means that any member of the project team can delete any issue in the project.

For some organizations, this scheme can be too permissive. If you find that users are deleting issues when they shouldn't be doing so and a stern warning or two doesn't discourage this behavior, consider one or more of the following alternatives. These modifications can be made by a system administrator or another user with the Manage Role permission.

  • Remove the Delete Issue permission from the default Contributor role. In this case, the ability to delete issues is restricted to system and project administrators.

  • Create a custom role that does not include the Delete Issue permission and assign this role to project teams on a per-project basis. This gives project administrators the ability to decide whether the members of their project teams can be trusted with issue deletion or not.

  • Create a custom role that includes only the Delete Issue permission. You can then grant this permission on a per-user basis to delete issues in specific projects.

Last modified: 08 March 2024