Archive a project
Put a finished or paused project away without deleting it. It becomes read-only, leaves everyday screens, and can be unarchived at any time.
For owners and admins
Archiving is for a project that’s finished or on hold. The project is put away, not deleted: it leaves the sidebar and the everyday screens, it becomes read-only, and everything in it stays readable under Archived projects. Unarchiving brings it back.
Owners and admins archive and unarchive. Everyone who could see the project before can still open it. Archiving is on every plan.
Archive a project#
A project can be archived with work still open. The one thing to do first is turn its support portal off, if it has one, so customers aren’t left writing to a desk nobody answers. See Set up a support portal.
- Open the project and choose Settings, then General.
- Under Archive project, choose Archive project….
- Read what will happen, then choose the button that says Archive and the project’s name.
A parent project’s sub-projects are archived with it, and a sub-project can’t be unarchived while its parent is archived. See Sub-projects.
What archiving does#
- It leaves everyday view. The project goes from the sidebar and from the lists you choose projects from. Its work goes from My Work, All work, the calendar, capacity, the dashboard and the roadmap.
- It becomes read-only. Nothing in it can be added, changed or deleted: tasks, outcomes, comments, attachments, bookings, tickets and the project’s own settings. Anything that tries is told the project is archived.
- Upcoming bookings are released. Time people had booked ahead on its tasks is freed, and a booking under way is cut off at that moment. Past bookings stay as history.
- Automatic work stops. Repeating tasks skip their dates, GitHub stops syncing the project, warnings about its tickets’ service levels aren’t sent, and an AI worker doesn’t start work that was queued on its tasks.
What you can still read#
Every page of an archived project still opens: its list, board and Gantt, its tasks and outcomes with their comments, attachments and history, its tickets and its settings. A banner across the top says when it was archived and by whom, and that it’s read-only. The controls on each page are switched off, add buttons are hidden, and cards and bars don’t drag.
Elsewhere:
- Search still finds the project, marked “Archived”. See Search.
- Reports keep counting work that was done in it, and list it as “(archived)”. History doesn’t change. See Reports.
- Project access lists still include it, marked “(archived)”, so access to it isn’t lost and can still be given. See Choose who sees a project.
- The support inbox still shows any tickets the team left open in it. They open read-only.
Find archived projects#
Once anything is archived, Archived projects appears under Projects in the sidebar. It lists every archived project you can see, most recently archived first, with:
- its name and type;
- when it was archived, and by whom;
- how many tasks it has, and how many weren’t done.
Search the list by name or project code. Open takes you into the project on its usual view.
Unarchive a project#
Owners and admins choose Unarchive beside the project on Archived projects, or on the banner at the top of any of its pages.
The project returns to the sidebar and its work to the everyday screens, as it was left. Repeating tasks carry on from their next date, and GitHub sync resumes.
One thing is caught up at that point. While a project is archived, changes to people’s access leave it untouched: someone who is suspended, removed, or limited to other projects keeps their name on its tasks. When the project is unarchived, their open work in it is unassigned then, so nobody returns holding work they can’t see.
Archiving and the Free plan#
The Free plan includes 3 live projects, and an archived project isn’t live. So:
- Archiving makes room. A Free workspace at its limit can archive a project and create another.
- Unarchiving needs room. If the workspace already has 3 live projects, unarchiving is refused until one is archived or the plan is upgraded.
Paid plans have no limit on live projects. See Projects and Plans and billing.
Archive or delete#
| Question | Archive | Delete |
|---|---|---|
| What’s kept | Everything, read-only | Nothing |
| Works on a project with tasks in it | Yes | No, the project must be empty |
| Can be reversed | Yes, with Unarchive | No |
An archived project can still be deleted, under the same rule as any other: only when it’s empty. See Delete a project.