YouTrack Standalone 2017.1 Help

Archive a Project

On this page:

Archive a Project

Every now and then you have a project that you aren't working on anymore, but don't feel like deleting just yet. You think you might need the data for reference, but don't want to receive notifications or see the issues from the project on your boards. You want a result similar to deleting a project, but without actually deleting it and losing all its data.

For such cases, you have the option to archive a project.

To archive a project:

  1. Select a project on the Projects page.
  2. Click the Archive project button.
    /help/img/youtrack/2017.1/archiveProject_thumbnail.png

Restore a Project

Unlike deleting a project, archiving is a reversible operation. You can easily restore an archived project when you need to.

To restore a project:

  1. Open the Projects page and select the name of an archived project.
    /help/img/youtrack/2017.1/unarchiveProject_thumbnail.png
  2. Click the Restore project button.

Archived Projects and Agile Boards

When a project is archived, any agile board associated with it becomes inaccessible. While in the case of a single-project board this is expected, in a cross-project board it is highly undesirable. When you attempt to archive a project that is used in one or more cross-project boards, you get a dialog with three actions:

OptionDescription
Remove from boardsArchive the project and remove it from any cross-project agile board it is associated with in the system.
IgnoreIgnore the warning, archive the project and make any cross-project agile board that uses the project inaccessible. On your own head be it!
CancelCancel archiving the project.

Archived Projects and Workflows

When a project is archived, all its workflows stop working. However, if a workflow rule affects issues in several projects (for example, methods related to issue links like issue.relates or issue.depends can return issues from any other project, including archived ones), then it will continue to work whether an issue's project is archived or not.

To prevent such behaviour, use the isArchived() method for the project. For example:

for each subtask in issue.parent { if (subtask.project.isArchived()) { continue; } // specify the actions to apply to issues in unarchived projects }

Archived Projects and Merged User Accounts

When you merge two user accounts, the resulting set of permissions is the sum of permissions each of the two users had previously. You may encounter strange results when you archive projects with private fields.

Let's say a user (let's call him 'john.d') has permission to view private fields in Project A, and another user (let's call him 'j.doe') does not have this permission. You archive Project A, and and later decide to merge the user account for 'john.d' into 'j.doe'. As result, the user account for 'j.doe' now has permission to view private fields in Project A. If you later restore Project A, this user, who originally did not have permission to view private fields in the project, can now see them.

If the two merged accounts belong to the same person, this might not be a big deal. If you merge two accounts that belong to different users, keep this possibility in mind.

Last modified: 18 April 2017