Archive a Project
On this page:
- Archive a Project
- Restore a Project
- Archived Projects and Agile Boards
- Archived Projects and Workflows
- Archived Projects and Merged User Accounts
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:
- Select a project on the Projects page.
- Click the Archive project button.
- Under certain conditions (for example, if the project is used in cross-project agile boards), you are asked to confirm the operation.
- The selected project is archived. You can no longer create issues in the project.
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:
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:
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.