List a Forge successor to a Connect app
This page covers how to submit your Forge app to the Marketplace in order to replace your existing Connect app.
Before you begin
At this point, you should have already integrated your Connect app with Forge. See Migrate an app from Connect to Forge for detailed instructions (including known issues and limitations).
You'll also need to enable sharing on your app. This will allow you to distribute it via the developer console. See Distribute your apps for detailed instructions.
Read the following details before submitting your app to be listed on the Marketplace.
Ensure your app manages personal data appropriately
If your app stores personal data, it must comply with user privacy requirements, as detailed by the General Data Protection Regulation (GDPR).
Follow the Forge user privacy guidelines to implement flows to report and erase personal data as appropriate.
Templates for End User Terms and Data Processing Addendums (DPA)
To transact with customers in cloud, you'll need End User Terms, also known as a customer agreement or Terms of Service (TOS). Also, if you are a Data Processor under GDPR, or process personal data under other personal data laws and/or regulations, you'll need a DPA.
If you don’t have these documents yet, Bonterms offers Atlassian-endorsed customizable templates for SaaS subscriptions, built by experienced lawyers. Bonterms legal templates are free to download and use — consult with your legal counsel to see if they can work for you.
Use the development or staging environment to test paid apps
Forge apps can be deployed to development, staging, and production environments. If you're listing a paid app, you must always use the development or staging environment to test your app. This is because all installations of production paid apps are billed. Even if you're the app developer, if you install your production paid app on your Atlassian cloud instance just to test it, you will be charged for it.
Note that Forge as a platform remains free to use.
Step 1: 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.
Step 2: Install the Forge version
Once the Forge version's Marketplace listing is approved, install it. You can do so via Universal Plugin Manager (UPM) or Marketplace.
Option 1: UPM
You should see an available update for your Connect app in the UPM.
Select Update and refresh the page.
Option 2: Marketplace
You can install the Forge app on a new site via the Marketplace.
FAQ
How do I rollback a Forge app to its previous Connect app version?
Mistakes happen. In case of an emergency, you can ask our team to manually rollback the migration. To do this, please raise a Marketplace Support ticket under Need help with Marketplace listing?.
How can I do a staged migration from Connect to Forge?
If you would like to follow a staged migration, please raise a Marketplace Support ticket under Need help with Marketplace listing?
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
Give feedback
We're excited to hear your feedback. Please join us in the Forge developer community.
Rate this page: