Last updated Aug 31, 2021

Rate this page:

Retiring your app

As the Marketplace grows, it's important for app users to be able to find current, relevant apps. Therefore, we try to retire apps that are no longer relevant or compatible with their Atlassian products. This helps Marketplace visitors easily discover current and relevant apps, and reduces the likelihood of finding outdated apps.

There are two ways for apps to become retired:

Automatic retiring of apps

The Marketplace automatically retires an app if the time since the end-of-life (EOL) of the latest version of the Atlassian product that the app supports is more than one year.

Automatic retiring of apps works for both cloud and server apps. For EOL dates of Atlassian products and product versions, see Atlassian Support End of Life Policy.

Manual retiring of apps

We have EOL terms for manually retiring apps that are paid via Atlassian. The following terms only apply to apps with active customers:

  • Communicate the upcoming EOL to your customers effectively via emails, blogs, marketing, or other channels.
  • Remember that you are obligated to support your current customers for the terms of any maintenance they have already purchased. For example, if a customer bought your server app last week, you must support them for 51 more weeks.
  • For cloud apps under a monthly subscription, there is a 60-day transition period during which customers are moved off of their paid subscription.
  • Archive or delete the app listings on the agreed date.

How to manually retire your app

The process for manually retiring an app works slightly differently for each app type. Read the section that corresponds to your situation below:

Only Atlassian Marketplace team members can manually archive Atlassian server apps.

If your app contains server versions, you need to do the following:

  1. Communicate the EOL to your customers, with a minimum notice period of 90 days.
  2. Raise a ticket with the Atlassian Marketplace team at our Service Desk, explaining that you'd like to archive the app, and giving the details of the customer communications you've sent. The Atlassian Marketplace team will set the discoverability of the app to Hidden on the Marketplace site, manageable in UPM if already installed. This prevents new customers from finding the app.
  3. Once all is confirmed (customer communications, commitment to fulfilling customer maintenance responsibilities), we can archive the app to prevent new purchases and existing customers from renewing.

Once the app is archived, you may still need to release bug fix versions to customers, as part of your ongoing maintenance responsibilities. In these situations, you can either:

Atlassian cloud apps built with Forge and Connect can only be deleted from the Marketplace; they can't be manually archived. Unlike with server apps, once you delete a cloud app, the app stops working for all customers.

If your app only contains cloud versions, you need to:

  1. Communicate the EOL to your customers, with a minimum notice period of 90 days.
  2. Raise a ticket with the Atlassian Marketplace team at our Service Desk, explaining that you'd like to retire the app, and giving the details of the customer communications you've sent. The Atlassian Marketplace team will set the discoverability of the app to Hidden on the Marketplace site, manageable in UPM if already installed. This prevents new customers from finding the app, but does not prevent existing customers from renewing.
  3. To prevent existing customers from renewing their subscriptions, you need to release a new version of your app with the payment model set to Free. All customers are then upgraded to the new version. After 60 days, the new price change goes into effect.

Once the final maintenance date has passed for the last customer's license, we are then able to delete the cloud app from the Marketplace.

When retiring Forge apps, app data in storage is marked as “to be deleted” and would often be deleted within a few days and up to 30 days in accordance with the Atlassian privacy policy. The intention is to allow users to reinstall their app and discover that none of their data has been lost, effectively letting the app work as expected.

It's currently only possible to archive a whole app listing. This means that you can’t archive just the cloud or server version of an app. Note that only an Atlassian Marketplace team member can archive an app.

Atlassian cloud apps can only be deleted from the Marketplace; they cannot be manually archived. Unlike with server apps, once you delete a cloud app, the app ceases to function for all customers.

If your app contains both cloud and server versions, you need to do the following:

  1. Communicate the EOL to your customers, with a minimum notice period of 90 days.
  2. Raise a ticket with the Atlassian Marketplace team at our Service Desk, explaining that you'd like to archive the app, and giving the details of the customer communications you've sent. The Atlassian Marketplace team will set the discoverability of the app to Hidden on the Marketplace site, manageable in UPM if already installed. This prevents new customers from finding the app, but does not prevent existing customers from renewing.
  3. For the cloud version: to prevent existing customers from renewing their subscriptions, you need to release a new version of your app with the payment model set to Free. All customers are then upgraded to the new version. After 60 days, the new price change goes into effect.

Once the final maintenance date has passed for the last customer's license, we are then able to delete both cloud and server versions of the app from the Marketplace. If there are still customers with valid server licenses, you must adhere to the license agreement, and continue providing support until this period is up.

Free apps

Free apps still require some form of communication outlining that they are to be retired. However, this is more relevant to cloud apps because cloud apps stop working once removed from the Marketplace.

If you have a marketing platform, such as a blog, website, or forum, you can use this platform to announce the retirement of your app. If you have active customers, we recommend a notice period of 90 days.

Your app listing should also be updated to state that the app will be retired from the Marketplace on a particular date.

Once the communication has been distributed with ample warning, raise a ticket with the Atlassian Marketplace team at our Service Desk.

Rate this page: