Last updatedAug 6, 2019

Creating a Marketplace listing

Create your vendor profile in the Marketplace

Every app is associated with a vendor profile. A vendor profile is a business entity, like Adaptivist or John Smith. Your app code references your vendor name, which is displayed to end users in the UPM and in the Marketplace. You can create a vendor profile from scratch on the Atlassian Marketplace or you can associate yourself with an existing vendor.

  1. Log in to https://marketplace.atlassian.com/ with your vendor account.
  2. Click Manage vendor account from the profile menu in the upper right.
  3. Register your organization and contact details.
  4. Click Create vendor

Prepare your branding and marketing materials

Looks count when it comes to selling apps. Atlassian requires that your app have the required branding materials. Some of these materials you place with your source code in your app JAR. Other materials you upload on the submission form when when you list your app.

  1. Assemble required branding materials.
  2. Declare your marketing assets with your JAR or app source code. 
  3. Include your vendor name, app description, and version information in the pom.xml and descriptor file.

Test your work

Test your app in the Atlassian product or products that your app works with.

  1. Verify that licensing works with extra Timebomb licenses for testing.
  2. Ensure that your app adheres to all the approval guidelines.

Submit your app for approval

Now you can submit your app for approval from the Marketplace team.

  1. Log in to https://marketplace.atlassian.com/ with your vendor account.
  2. Click Publish a new app from the profile menu in the upper right.
  3. Fill out the submission form.
  4. Accept the Atlassian Marketplace Vendor Agreement.
  5. Submit your app for approval. For paid via Atlassian apps, supply your bank account details to receive remittances. This includes your bank name, address, account numbers, tax ID, and other information.

Each app is reviewed by a Marketplace support team member before being publicly listed. This process can take a while depending on the current number of submissions ahead of yours. Typically you should hear from a support member in 5 - 10 business days.

Market your app

After you receive approval from Atlassian, we recommend double-checking your app details page.

  1. Review your listing and make sure everything looks like you expected.
  2. Ensure you can install your app from the Marketplace, and that links and functionality are intact.
  3. Double-check that your vendor profile financial information is complete and correct.
  4. Promote your app and make the most of marketing.

Make money

Our systems record each app evaluation or trial of your app. As these evaluations progress, our automated system sends emails to remind customers that their evaluation ends soon. These emails also prompt users to purchase a full license. Then, watch the Atlassian system work for you via automated reports. These reports provide daily and monthly sales and license reports.

  1. Read up on sales and renewals for paid via Atlassian listings.
  2. View your reports for paid via Atlassian Listings.

Add a cloud version of your existing server app

If you already offer a server app and you're listing the cloud version of the same app, you should list them together (the inverse is also true). Each listing on Marketplace allows you to combine server and cloud versions with the same or different assets. This takes advantage of the SEO, ratings and reviews of your existing listing.  Your combined listing also looks more complete because both "server" and "cloud" models the listing display an available product.

To list your server and cloud app together, go to your current listing (i.e., server) and click "Create version", then submit your opposite deployment (i.e., cloud) version. You must use the same app key for both app types.

Add the Atlassian app licensing API to your app

Licensing controls let customers access your app from their Atlassian host product. Paid via Atlassian apps include the Atlassian app licensing API in order to be listed in the Marketplace.

Here's a tutorial to help you set this up.