Last updated Apr 10, 2024

List and manage apps

List your app in the Marketplace

Here's how to add your listing to the Marketplace:

  1. Log in to https://marketplace.atlassian.com/ with your partner account.
  2. Click Publish a new app from the profile menu in the upper right.
  3. If this is your first app submission, follow the prompts to register your partner and contact details.
  4. Click the Create app button.
  5. Fill out the form and upload your branding assets, and provide any other required information such as your End User Terms and Privacy Policy.
  6. When ready, click Submit for approval.

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.

Learn more about Bonterms customizable legal templates.

Atlassian reviews and approves new app listings before they appear on the Marketplace, but new versions don't require approval. 

If you're listing a cross-product paid via Atlassian app, repeat steps 3–6 for each supported product. Each supported product requires a separate listing. However, if you're listing an app that works for one product across different hosting models (like Confluence Cloud and locally hosted Confluence instances), you should list these apps together as different versions of the same app. Read more here.

How do I make sure my app gets approved?

Check out our approval guidelines.

What's the difference between app level and version level information?

In the Atlassian Marketplace, the app level encapsulates information that doesn't change. For example, the name, the partner, the key, etc. wouldn't change between app versions. The version is a downloadable artifact (usually a JAR file) that represents a single release. Each version can have different screenshots, release notes, and compatibility information.

Edit an app listing

You can edit directly from the Marketplace:

  1. Log in to https://marketplace.atlassian.com/ with your partner account.
  2. Click Manage vendor account from the profile menu in the upper right.
  3. Select the app you want to modify from the list.
  4. Make and save your changes.

How do I make sure my app appears in search results?

The Atlassian Marketplace uses a full-text search of the app title, description, and partner name. It also indexes the release notes you enter in each app version. You can optimize your search results by changing the content in these fields.

How do I announce cloud migration assistance availability on the app listing page?

You can announce the availability of this support by displaying the resources related to Cloud Migration Assistance on your app listing. This can be done by updating Marketplace migration APIs. You can use the add-on key to map your cloud listing and server listing through the Migration API. The Migration API documentation provides more information about this process.

Atlassian periodically chooses to feature a few apps. We look at general usefulness and popularity, determined by how many active product instances have your app installed. Featured apps appear as the Staff Picked category in the app list. In addition, we present targeted banner images in the carousel of the Atlassian Marketplace in the Find new apps page in the Universal Plugin Manager (UPM).

new apps

What happens to my app compatibility when Atlassian releases new product versions?

You specify product compatibility with your app in the Create new add-on form. When Atlassian releases minor versions that outpace your app's compatibility, we automatically update this information for you. For example, if your app is compatible with Confluence version 6.2, and version 6.3 comes out, we assume your app will still work and update your listing accordingly. This is also true for beta versions.

When a major version is released, we leave it up to you as the developer and partner to check compatibility. After you've confirmed that your app is compatible, you can update your listing and we'll move forward with minor releases as usual.

What if somebody posts an inappropriate review?

You can flag reviews as inappropriate, and our team will take a look. We also use spam-fighting software to prevent as many inappropriate reviews as we can. However, sometimes users post reviews that are well-intended, but contain incorrect information. In cases like these, you can respond to the review on the page to set the record straight, or email the reviewer directly.

Do I need to share my source code?

Only if your app is open-source. You can use Bitbucket to host your code.

That said, we find that sharing our code with customers increases their trust in our products, even though they're not open-source. We encourage you to share your source code with customers whenever possible.

How do I list a cross-product app?

Free and paid via vendor cross-product apps can be listed by specifying all the compatible applications when submitting the app version.

Paid via Atlassian app listings are product-specific in the Marketplace. List your app for each host product individually, and differentiate each app using specialized app keys. All other assets and artifacts can be left the same.

Here's an example of a modified app key for Jira:

1
2
<groupId>com.example.plugin.jira.thing</groupId>

Here's an example of a modified app key for Confluence: 

1
2
<groupId>com.example.plugin.confluence.thing</groupId>

Customers will need to license each separately.

If my app has the same functionality in server & cloud instances, do I need two listings?

Just one listing is enough. If your Atlassian Connect app does the same thing behind the firewall as it does in the cloud, keep it simple with a single listing. Even if your app uses different mechanisms to solve the same problem, use a single listing on the Marketplace site. Though you'll use a single listing, this listing requires two approvals. Our Marketplace team approves both the downloadable and hosted version of your app separately. 

Here's how an app with two hosting models can share a single listing:

  1. Create a single listing for one hosting model — server or cloud, it doesn't matter. Your app enters our Marketplace approval queue. 
  2. Click Create version and add the other hosting model as another version of your app. This version of your app, even if it has the same functionality, also enters our approval queue. 

Once both hosting models are approved, your public listing reflects both hosting models. 

Rate this page: