Last updated Feb 21, 2024

Listing your Forge successor app on Marketplace

This page covers how to submit your Forge app to the Marketplace to replace your existing Connect app.

Billing considerations

If you're listing a paid app, you must always use the development or staging environment to test your app.

All installations of paid production apps are billed. This includes:

  • if you install your production paid app on your Atlassian cloud instance

  • Forge apps installed on enterprise sandbox instances (regardless if they're installed on the enterprise's production instance).

To mitigate these, create a promotion to discount the costs.

Step 1: Enable sharing

If you haven't already, you also need to enable sharing on your app. This will allow you to distribute it via the developer console.

  1. Using the Forge CLI, deploy your app to the production environment.

  2. In the developer console, choose the app you want to share.

  3. Select Distribution in the left menu, and under 'Distribution controls', select Edit.

  4. Select the Sharing option, fill in the app details, and select Save changes.

Step 2: List your app as a Forge app

Once sharing is enabled, you can publish a new app version to the Marketplace by selecting the Forge app.

Screenshot of the screen to publish a new app version in Marketplace

Testing your Forge app

Once the Forge version's Marketplace listing is approved, you can install it via Universal Plugin Manager (UPM) or Marketplace.

FAQ

How do I roll back a Forge app to its previous Connect app version?

Mistakes happen. In case of an emergency, you can ask our team to manually roll back the migration. To do this, raise a Marketplace 'Edit your listing' Support ticket.

How can I do a staged migration from Connect to Forge?

If you would like to follow a staged migration, raise a Marketplace 'Edit your listing' Support ticket.

Example

  • Summary: Staged migration rollout from Connect to Forge

  • Description: I would like to control the rollout of my migrated Connect on Forge app, by initially restricting updates to the following test sites.

  • https://TESTINSTANCE.atlassian.net

  • App key: com.atlassian.confluence.extra.team-calendars

  • Listing management URL: https://marketplace.atlassian.com/manage/apps/12345/details

Stuck? Something not clear?

Rate this page: