Rate this page:
This changelog is the source of truth for all changes to the Marketplace that affect people publishing apps.
Posts are made in the Marketplace announcements category of the developer community when the changelog is updated. Subscribe to the Marketplace announcements category to get notifications.
We've modified the design of the Help section on the Marketplace partner page, under the apps, details, contacts, payment, promotions and security tabs. This change adds links to information that help you become familiar with the Marketplace ecosystem.
Before | After |
|---|---|
New Benchmarking and Customer insights are now generally available. This includes sales and evaluation benchmarking, four new customer insights and one additional insight.
These metrics are available via 7 new APIs:
Benchmarking APIs
Customer insights APIs
Additional insights
We recently launched a new developer support page, which serves as a centralized hub for reporting issues, managing your app and getting support. This page will streamline your experience of getting in contact with us for different areas of support:
Bugs: Report development or Marketplace bugs
Incidents: Report critical issues or breaking changes
App listing: Edit your app or access Marketplace APIs
Accounts and payment: Manage your Marketplace payments and licenses
App migration: Get help with creating a cloud version of your app
Security programs: Apply or adjust your program details
Partner resources: Request access to exclusive partner content
Ukraine support: Request emergency concessions or ask questions
If you have any questions, please get in touch with us via the developer community announcement.
Cloud apps on Atlassian Marketplace now offer the following new tiers for per-user pricing:
20,001 - 25,000
25,001-30,000
30,001-35,000
For more information on the new tiers, see our CDAC post and Partner portal page.
Pricing for the new tiers will default to the price for 20,000 users until Marketplace Partners add new per-user pricing for 20,001-25,000, 25,001-30,000, and 30,001-35,000.
The original Promotions endpoints have been deprecated and will be removed on 15 July 2022. New Promotions endpoints have been introduced to allow you to manage your promotions for Cloud apps, as well as Server and Data Center apps.
For more information about what’s possible with the new endpoints, see the Cloud Promo Codes GA page.
We have updated our security requirements for cloud applications, added new security requirements, and categorized requirements by app type and security requirement type. All cloud applications in the Atlassian Marketplace must adhere to the updated requirements by October 31, 2022.
Please see the blog post and FAQ page accompanying this announcement for more details, as well as this document for specific updates.
We’ve changed the permissions required for bulk get statuses and search statuses paginated. We’ve also added the option to filter by status category in search statuses paginated.
The permissions required for bulk get statuses and search statuses paginated are now:
Administer projects project permission for the projects that use the statuses
Administer Jira admin permission for the tenant
We’ve also added the option to filter the results by status category: TODO, IN_PROGRESS, DONE.
The following API methods will now include $0 transactions resulting from 100% discounts:
/rest/2/vendors/{vendorId}/reporting/sales/transactions
/rest/2/vendors/{vendorId}/reporting/sales/transactions/export
You can retrieve $0 transactions from July 1, 2019 onwards. For detailed information about this change, refer to the following Developer Community post: https://community.developer.atlassian.com/t/0-transactions-will-be-added-to-marketplace-apis-on-june-9-2022/58809
Each $0 transaction will contain the transaction IDs and the discount amount (manualDiscountAmount, expertDiscountAmount or marketplacePromotionDiscountAmount). The transaction amount will be 0.
The discount fields will contain what would have otherwise been the transaction amount, while vendorAmount will be 0. For example: "vendorAmount":0, "manualDiscountAmount":496.19. To exclude these new transactions, set the excludeZeroTransactions query parameter to true.
For more information about $0 transactions, refer to https://developer.atlassian.com/platform/marketplace/rest/v2/api-group-reporting/#api-vendors-vendorid-reporting-sales-transactions-get.
To comply with EU Directive 2019/2161 and the FTC Consumer Review guidelines, which aim to protect users from fake online product reviews, Atlassian has made two adjustments to the app reviews section on the Marketplace app listing page.
Before publishing a review, we ask users to accept the new terms and conditions by confirming they are or were recent users of the app they are reviewing.
We’ve added an info bar to the Reviews tab on every Marketplace listing, letting visitors know about the new review guidelines.
Existing reviews are not impacted; only new reviews will be affected.
These changes will become visible on the Marketplace by the end of May 2022.
We’ve added 5 new operations that enable you to create, update, and delete statuses as well as get statuses in bulk using their IDs and search statuses by name or the project they used in.
The 5 new operations are:
Bulk create statuses – Creates statuses for a global or project scope.
Bulk update statuses – Updates statuses by ID.
Bulk delete statuses – Deletes statuses by ID if they're not being used.
Bulk get statuses – Returns a list of the statuses specified by one or more status IDs.
Search statuses paginated – Returns a paginated list of statuses that match a search on name or project.
The bulk get statuses and search status paginated operations include an expand option that returns details of the project and issue types that use the statuses.
Marketplace Partners and their customers can now view badges corresponding to their partner tier on marketplace.atlassian.com. This partner badge is visible on the partner profile page and app listing page of a partner that qualifies under the https://developer.atlassian.com/platform/marketplace/marketplace-partner-program/.
Marketplace Partners can now capture user journeys, installs, and app requests for Marketplace apps using Segment. Learn how in the guide https://developer.atlassian.com/platform/marketplace/marketplace-integration-with-segment/.
The original Promotions endpoints were marked deprecated in April 2021, when we announced GA availability of Cloud app promotions. New Promotions endpoints have been introduced to allow you to manage your promotions for Cloud apps, as well as Server and Data Center apps.
We have been monitoring the original promotions endpoints, and there has been no traffic for about 3 months. Therefore we are removing the original endpoints on 30 June 2022.
For more information about what’s possible with the new endpoints, see the Cloud Promo Codes GA page.
You can now migrate your Connect app listing and installations to Forge. Navigate to the management view of your Marketplace listing, then select a Forge app with a matching app.connect.key as the new version.
Admins of sites that use your app’s Connect version will be prompted to update to the Forge version (in the “Manage Apps” screen). When they accept, the installation will be replaced by the Forge version.
You can request a staged rollout of the upgrade by raising a Marketplace support ticket listing which sites see the upgrade.
See Migrate an app from Connect to Forge for more information on how to migrate your app (including known issues and limitations with doing so). Then, see Listing a Forge successor to a Connect app for information on how to update your listing with a migrated app.