Documentation
Repo Archiver — How it works
What this product does
Repo Archiver is one product installed in two places — a Jira app and a companion Bitbucket app. They work together but are independent Forge apps under the hood.
Repo Archiver for Jira
The Marketplace app. Connects to your Bitbucket account via OAuth and shows a report of every repository across your workspaces — classified as Active, Stale (no activity in 90+ days), or Archived. Helps you spot repos that need to be cleaned up without leaving Jira.
Bitbucket Repo Archiver
The companion Bitbucket app. Does the actual archiving: moves a repository into a dedicated "📦 Archived" project, blocks pull request merges into it, and shows a clear archived notice on its Source page. Available via a direct installation link (not the Marketplace — Bitbucket-only Forge apps can't be listed there yet).
The split exists because Bitbucket-only Forge apps are not eligible for Atlassian Marketplace listing. The Jira app is the paid Marketplace product; the Bitbucket app is free and installed via a direct link surfaced from inside the Jira app.
How to test — step by step
Install Repo Archiver for Jira
Install the app from the Atlassian Marketplace onto your Jira Cloud instance.
Review the Get started page
In Jira: Apps → Manage apps → Repo Archiver for Jira → Get started. This page gives a brief overview and is the entry point Atlassian surfaces during app evaluation.
Open the app from the Jira navigation
In Jira: top navigation bar → Apps → Repo Archiver for Jira. This opens the global page — the main reporting surface of the app.
Connect to Bitbucket
Click Connect to Bitbucket. A Bitbucket OAuth consent popup opens — approve it to grant the app read access to your repositories and workspaces. This is a one-time, per-user step; credentials are stored securely by the Forge platform (not by this app).
Browse workspaces and repositories
After connecting, the page lists every Bitbucket workspace your account belongs to. Click a workspace to expand it — repositories load on first expand. Each repository is labeled:
- Active — updated within the last 90 days
- Stale — no activity in 90+ days, candidate for archiving
- Archived — already moved into the "📦 Archived" project by the Bitbucket app
(Optional) Install the Bitbucket app to test archiving
The "Install the Bitbucket app" button shown in the Jira app opens the direct installation link for the companion Bitbucket app. Once installed on a Bitbucket workspace, you can:
- Go to any repository in Bitbucket → Settings → Repo Archiver → toggle the archive switch.
- Or use Workspace settings → Repo Archiver to bulk-archive multiple repositories at once.
Common questions
Do I need the Bitbucket app to use the Jira app?
No. The Jira app works independently — it reads repository data from the Bitbucket API using your OAuth credentials. The Bitbucket app is only needed if you want to actually archive repositories (not just report on them).
Why isn't the Bitbucket app on the Marketplace?
Atlassian does not currently support publishing Bitbucket-only Forge apps to the Marketplace. This is tracked at ECO-198. Until that changes, the Bitbucket app is distributed via a direct installation link, which the Jira app surfaces in-app.
What data does the app access?
The Jira app requests Account: Read and Repositories: Read OAuth scopes from Bitbucket — enough to list workspaces and repositories. It never writes to Bitbucket and stores no data of its own; everything is fetched live on each page load.
In October 2021 we were deeply moved by the situation at the Polish-Belarus border where thousands of people were trapped at the center of an intensifying geopolitical dispute.
We decided to pay 10% of our revenue (not profit, revenue) to a coalition of human rights organizations Border Group. The group includes people we know in person, as well as members of the Helsinki Foundation for Human Rights.
In February 2022 the border crisis seemed to shade. But as we all know it was replaced by something much worse. We hoped we would never use word “war” in this context.
We donate help for fighting Ukraine. Either through NGOs or via our network of friends who are personally involved in the matter.