Last updatedSep 12, 2019

Retiring your app

About app archiving

As the Marketplace grows, it's important for app users to be able to find current, relevant apps. For this reason, we archive apps that are no longer relevant or compatible with their Atlassian host products. This helps Marketplace visitors easily discover current and relevant apps, and reduces the likelihood of coming across those which are outdated or obsolete.

The Marketplace archives apps automatically if the time since the end-of-life of the latest version of the Atlassian application it supports is greater than one year.

For EOL dates of Atlassian products and product versions, see Atlassian Support End of Life Policy.

The auto archive job works for both Cloud and Server apps. The process for manually retiring an app works slightly differently for each app type.

Only an Atlassian Marketplace team member can archive an app. Please read the section that corresponds to your situation.

How to retire your app

We have end of life terms for deleting or archiving all Paid via Atlassian apps. These terms only apply to apps with active customer.

  • Communicate the upcoming EOL to your customers via any medium which is effective at reaching your customers for example: direct emails, blogs, or other marketing avenues at your disposal.
  • 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 will be a 60 day transition period where customers are moved off of their paid subscription.
  • Archive/delete the listing(s) on the agreed date.

If your app contains Server versions:

  1. Communicate the EOL to your customers (90 days minimum notice).

  2. Raise a ticket with the Atlassian Marketplace team at our Service Desk, stating your intent to archive the app with the details of the customer communications you have sent. The Atlassian Marketplace team will then set the discoverability of the app to Hidden on the Marketplace site, manageable in UPM if already installed. This will prevent 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 there may be times you need to release bug fix versions to customers as part of your ongoing maintenance responsibilities. In these situations you can either provide the fix directly to the affected customers or get in touch with us via our Service Desk whereby we can; unarchive the app, release your fix version, and we will then proceed to re-archive the app.

If your app only contains Cloud versions:

  1. Communicate the EOL to your customers (90 days minimum notice).

  2. Raise a ticket with the Atlassian Marketplace team at our Service Desk, stating your intent to archive the app. Provide the details of the customer communications you have 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 will prevent new customers from finding the app but will not prevent existing customers from renewing.

  3. To prevent existing customers from renewing their subscriptions, you will need to release a new version of your app with the payment model set to Free. All customers will be upgraded to this new version. After 60 days, the new price change will go into effect.

    • Cloud apps cannot be archived manually on the Marketplace, they can only be deleted.
    • Unlike with Server apps, once you delete a Cloud app will cease to function for all customers.
  4. 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.

It's currently only possible to archive a whole app listing. You can’t archive just the Cloud or Server version separately. If your app contains both Server and Cloud versions:

  1. Communicate the EOL to your customers (90 days minimum notice).

  2. Raise a ticket with the Atlassian Marketplace team at our Service Desk, stating your intent to archive the app. Provide the details of the customer communications that you’ve sent. The Atlassian Marketplace team will then set the discoverability of the app to Hidden on the Marketplace site, manageable in UPM if already installed. This will prevent new customers from finding the app but will not prevent existing customers from renewing.

  3. For the Cloud version: to prevent existing customers from renewing their subscriptions, you will need to release a new version of your app with the payment model set to Free. All customers will be upgraded to this new version and after a 60 day period the new price change will come into effect. The App will be set to hidden so no new customers will be able to install it.

    • Cloud apps cannot be archived manually on the Marketplace; they can only be deleted.
    • Unlike Server apps, once you delete a Cloud app it will cease to function for all customers.
  4. Once the final maintenance date has passed for the last customer's license we can delete the app (both Server and Cloud versions) from the Marketplace. If there are still customers with valid Server licenses then 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, this is more prominent for Cloud apps as they will cease to work for customers once removed from the Marketplace.

If you have a marketing platform such as; a blog, website, forum etc then you can utilise this to announce the impending retirement of your app, again 90 days is the recommended pre-warning if you have active customers.

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

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