Atlassian Marketplace Developer

Atlassian Marketplace Developer

Last updatedJun 5, 2020

Rate this page:

Sales promotions

App discount (promo) codes are only available for Paid via Atlassian server apps. Cloud apps are currently not eligible to be sold at discount.

You can create promotions for paid via Atlassian apps you sell for downloaded instances of Atlassian products. The Marketplace provides a customer-friendly URL for users to apply and access your promotion. This is the only way for customers to access and apply the discount--promotions aren't outwardly visible on the Marketplace site. Customers accessing your promotion URL are directed to a specialized checkout page, detailing the sale price of the app.  

Promotion eligibility

Promotions are available for paid via Atlassian apps compatible with server and Data Center versions of Atlassian products. The list below shows a breakdown of which license types, sale types and hosting models are eligible for promotions.

  • Payment model: Paid via Atlassian only
  • Hosting: Server or Data Center (cloud products are not currently eligible for promotions)
  • License types: Commercial and academic licenses
  • Sale types: New purchases, renewals and upgrades

Customers can always use promotions for any eligible license or sale type. For example, if you create a promotion for a Jira app, you don't need to specify that it applies to new, renewal or upgrade purchases; it can automatically be used for any of these. There is no way for you to limit a promotion to one license or sale type.

A given promotion applies only to the initial transaction where it was used. For example, if a customer uses the promotion for a discounted first-time purchase of your app, the discount only applies to that purchase transaction. If the customer purchases additional maintenance as part of that transaction it will also be discounted. However, when the customer subsequently wants to renew maintenance, the promotion discount no longer applies and they'll need to pay full price for the renewal.

When a promotion is applied to an academic license purchase, the 50% academic discount applies in addition to the promotion discount.

Promotions for Bamboo apps can be used only for new commercial licenses. They cannot be used for academic licenses, renewals or upgrades.

Customer promotion experience

To distribute promotions, provide a URL from the Marketplace to your customer(s) directly. When customers follow your link, your app is added to their cart with the promotion applied. The promotion URL is automatically created when you complete the steps in the section ahead. Here's an example of a promotion URL:


Creating a promotion

You can create any number of promotions simultaneously for your paid via Atlassian apps. You can create single-use promotions, meaning that the URLs can only be used by one customer. Accordingly, single-use promotions should only be shared with one customer since all URLs are unique. You can also create multi-use promotions. Multi-use promotions use the same URL and can be used by as many customers as you permit. You can also create promotions for multiple apps, called bundled promotions. All apps must be for the same application and be paid via Atlassian to qualify, and all apps in the bundle need to be purchased for the customer to receive the discount.

When creating a promotion, you’ll be prompted to specify whether it should be for server or Data Center. A promotion can’t mix server and Data Center apps.

Here's how to create a promotion: 

  1. Log in to with your partner account.
  2. Click Manage vendor account from the profile menu in the upper right.
  3. Click Promotions.
  4. Click Create promotion
  5. Complete each section and click Next to navigate forward. 
  6. Click Submit on the Confirmation screen to create your promotion.
  7. Copy the URL from the subsequent Promotions page. Use this URL to share with your customers. Customers can follow this link and have the promotion automatically applied to their cart.

Modifying a promotion

You can edit a live promotion any time. Promotions that have already ended can't be edited retroactively, of course, but ongoing promotions permit the following changes:

  • Promotion name: You can rename your promotion anything you like.
  • Maximum number of uses: For multi-use sharable promotions, you can raise the number of times your promotion can be used. 
  • Extend the end date: You can extend a promotion any time. Promotions are intentionally designed not to be shortened since this is a confusing experience for customers.

To edit a promotion, navigate to your Manage vendor account page. From here, click the pencil icon to edit a promotion.

Ending a promotion early

The only way to end a promotion early is to file a ticket in our tracker. We advise only terminating promotions only when absolutely necessary, since this can result in a suboptimal customer experience.

Promotions and sales reports

When a customer uses a promotion and finalizes a sale, you'll see this sale reflected in your sales reports.

There are two scenarios when promotions appear used, but aren't immediately visible in your sales reports: 

  1. A promotion code is considered used when it's included in a sales quote. If the customer moves forward with the sale, the license and sale are accordingly shown in your sales reports. Quotes are valid for 30 days, and if the customer doesn't move forward with the sale the promotion will show as unused after this time. 
  2. Alternatively, if an order is flagged for review--for example, if our system detects a potential error in the order--we review the order before the sale is finalized. Once the sale is finalized, it's reflected in your sales report. 

Also, note that 100% off promotions result in a $0 "sale" and are therefore not reflected in sales reports.

Rate this page: