Archive a team
We recommend archiving over deleting as archiving keeps historical connections and data.
Archiving a team
Archiving a team helps you keep your workspace organized by hiding teams that are no longer active. All of the team’s work, history, and references remain accessible. This means you don’t lose any important information. You simply remove inactive teams from everyday views.
Once you’ve archived a team:
The team profile becomes read-only and visually marked as Archived.
The team is hidden from pickers, mentions, and search by default.
All links to work (issues, projects, goals, etc.) remain intact.
Team members are notified when a team is archived.
The team can be restored at any time.
They can be found in the Archived teams tab in the Teams directory.
You cannot assign new work to an archived team.
When a team is archived, it will show a grey team avatar and a grey ‘archived’ lozenge next to the team name.
How to archive a team
Go to the team profile page.
Select the menu icon
….Select Archive team.
Confirm the action in the popup modal.
Only users with the right permissions can archive a team i.e. team members or org admins.
Managed teams must be disconnected from an external source before they are archived. This can only be performed by the org admin.
How to restore a team
Only users with the right permissions can archive or restore teams i.e. team members or org admins.
Go to the team profile page.
Select the menu icon
….Select Unarchive team.
Confirm the action in the popup modal.
When you restore a team, it’s original team hierarchy will not be reinstated.
Finding an archived team
You can find archived teams in the team directory by selecting the Archived tab.
Notifications and permissions
Only team members will be notified when a team is archived. Any permissions granted remain and will not be revoked.
Team hierarchy
When you archive a team that’s part of a team hierarchy (with parent or child teams):
If the team has only child teams, those child teams will no longer have a parent.
If the team has only a parent team, that parent will no longer have this team as a child.
If the team has both a parent and child teams, the child teams will be moved up and connected to the grandparent team.
When you unarchive a team in a team hierarchy, the original team hierarchy will not be reinstated.
Impact on apps and features
Feature | Behaviour |
|---|---|
Team profile page | Profile is read-only and marked as archived. |
Jira team field | Team remains on issues with grey team avatar, but team is not assignable to new work. |
JQL | JQL queries referencing the team still work. |
Confluence | Existing team mentions and smart links remain, but team is marked as archived. |
Automation | Rules referencing the team remain, but team is not assignable. |
Atlassian projects and goals | Team remains on projects and goals with grey team avatar, but team is not assignable to new work. |
Jira Service Management operations | Alerts that were created before archiving will continue to be sent to the archived team. To stop these alert notifications, you’ll need to manually unlink the team from any associated schedules and alerts. Users can still assign schedules to an archived team on the team’s profile page in Jira Service Management. |
Compass | Team remains on Compass components, but team is not assignable to new components. |
Was this helpful?