| Question | Answer |
|---|---|
| What are app editions? | App editions let partners monetize premium features for high-demand customers while offering affordable options for price-sensitive users. This expands the app’s market by providing multiple pricing offerings in a single paid Marketplace listing. |
| What are the requirements for app editions? |
|
| Are editions available for all Atlassian deployment options: cloud, Data Center, and server? | App editions are only available for cloud apps, to align with how Atlassian products only have editions for cloud. |
| If I plan to offer different editions of my app, can I choose how my current app is categorized? Additionally, if my app is currently built for a higher-paying audience, would it be possible to introduce a lower-tier standard edition with app editions? | You aren't currently able to classify your current app as an Advanced edition. We are exploring implementation for future releases from both business and technical perspectives. |
| Will editions be visible for all apps, or can we choose which apps to build editions for? | You can decide which of your apps will participate in app editions. Feature sets and pricing will be visible at multiple touchpoints based on the app's participation. We recommend considering app editions for both existing and new apps, as this creates an effective flywheel to attract customers and enable up-sell opportunities. The effort required to set up editions for an app is minimal. |
| What will my app editions journey look like? |
Your app editions journey will be divided into three key phases:
|
| Will there be support for archiving editions (within an app)? | Archiving an edition is not yet supported. This means that once an edition is created, it remains part of the app. However, you have several creative options, such as adjusting the feature sets or changing the pricing within the editions. |
| Question | Answer |
|---|---|
| How can I plan my app editions? | We have put together a few resources for you to plan your editions and think about your pricing, packaging, and overall strategy. Visit our Pricing and packaging guide to learn more. |
| How can I find out which parent product editions my current customer base is using to formulate my app editions strategy? | This information is currently available in the license report available to Marketplace partners. To see this information, Marketplace partners can download the license report and get the edition of the parent product from the field parentProductplan. |
| Question | Answer |
| How do app editions work? Are there any specific technical instructions that Marketplace Partners must follow to support editions for their apps? |
Partners need to introduce conditional logic in their app code, depending on their app’s functions and how these are coded. This conditional logic provides the differentiation of features and services between Standard and Advanced editions of their apps. |
| How can developers integrate app editions into their apps? |
Developers can utilize various touch-points to integrate edition-level experiences into their apps, such as:
These tools will allow developers to differentiate features based on a customer’s edition and write conditional logic to tailor the app experience. |
| Is the capabilitySet available in all API interactions? |
The capabilitySet has been added to several API interactions, including installation lifecycle events and the Connect License API, to provide consistent edition information across all relevant touch-points. The existing locations where licensing could be consumed in apps have been extended to provide context around which edition a customer is on. |
| How is capabilitySet used? |
The capabilitySet defines a customer's feature access level—
Ideally, you would want all customers with a status of |
| When a customer upgrades/downgrades from one edition to another, do the IDs remain the same? (i.e EntitlementId, EntitlementNumber etc.) |
Yes, they remain the same. As part of upgrades and downgrades, app identifiers, such as Entitlement Number and EntitlementId, don't get updated. |
| Do the installationId and clientKey remain the same? |
Yes, the installationId and clientKey remain the same. |
| Is the Entitlement Number unique for Standard/Advanced editions? |
The Entitlement Number remains the same, with only the edition or edition changing. |
| Do I need to release a new version of an app before creating an Advanced edition? |
No, you don’t need to publish a new version to publish editions. |
| Should versioning for Standard/Advanced editions be aligned or segregated? |
The same version will be used across Standard and Advanced editions, with differences managed by feature flags in the app descriptors. |
| Question | Answer |
|---|---|
| How do I publish my editions? |
You can publish your editions through the Editions tab in your Marketplace partner account. The process is divided into three key phases:
|
| What is the review process for app edition approval? | Once you submit your app editions for review, a support ticket will automatically be created in ECOHELP JSM to notify the app review team of your submission. You can interact directly with the review team through this ticket. If you don't have access, you can request it via support . The review will test both Standard and Advanced features to ensure proper licensing validations. If rejected, you’ll need to address the feedback and resubmit. Once approved, the edition will be available for customer upgrades. |
| Are there be more reviews by Atlassian after the initial Advanced edition review? | No, only the initial review is manual. Subsequent updates to features won’t trigger a review. |
| How often can updates be submitted to the feature map without changing prices? | Updates can be submitted as often as needed without changing prices. There are no limitations on updating the feature map. |
| What permissions are required for the Editions tab to be visible and configurable on the Marketplace Partner Console? | The Editions wizard enables partner users to update feature descriptions and pricing. Therefore, users must have both "Manage app details" and "Manage app pricing" permissions to access the Editions tab. |
| Question | Answer |
|---|---|
| What is revenue share for Advanced app editions? | The revenue share is defined at the app level and will be the same for both Standard and Advanced editions. |
| Are pricing rules for the Advanced edition different from the existing pricing rules? | All existing pricing rules and constraints for apps apply to both Standard and Advanced editions. The key addition for Advanced editions is that their pricing must be higher than, or equal to, that of the Standard edition. Additionally, offering a free flat tier for Advanced editions is not possible. |
| Are there rules or restrictions around pricing/packaging editions? | No, partners have the freedom to determine how they want to price and package their editions. |
| Question | Answer |
|---|---|
| How can I access relevant reports related to app editions? | You can do this through several types of reports. The Licenses report includes fields specific to app editions, providing data points such as the edition the customer is on and details for upgrade trials. The Transactions report will also have a field indicating the edition for which a transaction is created. Additionally, the Evaluations report will now include net new evaluations and upgrade evaluations, while the Conversion report will reflect net new conversions and upgrade conversions. The Feedback report will include a new field indicating the latest edition for which feedback was left during uninstallation, and the License Event Feedback will contain a new field depicting the edition of the license against which relevant events (churn, conversion, or renewal) are fired. For more information, see Accessing reports. |
| Is there a data field indicating if an Advanced trial is from an existing Standard customer? | The license of an existing Standard customer remains as Standard. However, there are three new fields in the Licenses report that indicate the ongoing trial of the app’s Advanced edition. These new fields will show the edition they’re trialing (which is Advanced), the start date, and the end date of the trial. |
| Question | Answer |
|---|---|
| What is the customer upgrade/downgrade experience? | Customers can upgrade and downgrade their editions through Marketplace, in-product Marketplace, Admin Hub and Billing console. To learn how customers do this, see Install and manage app access. |
| If customers are on a paid Standard subscription and are trialing an Advanced edition, will they be charged during the trial period? | During the trial period, customers will continue to be charged for their existing Standard subscription. After the trial ends and they convert, they will be charged for the Advanced edition. |
| Will there be two active licenses for a paying Standard customer on an Advanced trial? | No, there will be a single license showing the edition as Advanced under evaluation. The transaction report will show the Standard edition as the paid version during the trial period. |
| Will Marketplace reviews specify which edition the customer is using, and can reviews be filtered by edition? | This capability won’t be available in the initial milestones but is being considered for future releases. For now, feedback is collected at the app level, not by edition. |
| How long are the trials? | Customers have a 30-day trial period. They can also extend their trials through customer advocates, similar to Standard trials. If they are satisfied with the app, they will transition to a paid edition. Additionally, customers can downgrade to the Standard edition during their trial. It's important to note that opting out is only available for trials. Once a customer moves to an Advanced subscription, downgrades can only occur at the end of the billing cycle and are scheduled, not immediate. |
| What kind of advanced features or support are customers requesting? | Customers frequently request enterprise-grade features such as enhanced support, BYOK, 99.9% SLA, compliance, Advanced analytics, improved data residency and security, and audit logging. However, partners should gain more insight into which features to add to the Advanced editions based on their research, customer feedback, competitive landscape, support tickets, and growth editions. We recommend that you begin focusing on certain enterprise-level features and those that enhance the attractiveness of cloud offerings for your Advanced editions. |
| In case of any doubts, who can I reach out to? | You can reach out to the team through the support desk: Questions about Marketplace. |
| How are upgrades and downgrades scheduled? | Upgrades take effect immediately, while downgrades are scheduled to occur at the end of the billing period. However, if a Standard paying customer is on an Advanced trial and chooses to opt out, the opt-out takes effect immediately, and the customer reverts to their Standard paid subscription without the Advanced trial. |
| What happens if a customer is on an old version that doesn’t auto-update, and the partner introduces editions in the code? If the customer then upgrades to the Advanced edition but remains on the old version, what happens? | Customers must be on the latest app version to access the features. Even if they upgrade to an Advanced subscription, they won't have access to the Advanced features unless they also update their app version to the artifact that includes those features. We have highlighted this to customers in the UI and documentation. |
| What happens to customers with Sandbox? |
A customer with standard edition on a production instance will be able to: - Use Standard edition for free on Sandbox: Customers will be able to install the Standard edition of that app and use it for free on their sandbox instance - Use Advanced edition for a payment on Sandbox: Customers will be able to install the Advanced edition of that app and use with a paid subscription in their sandbox instance. For example, a customer has the Standard edition of app X on their production instance, they will be able to install and use the Advanced edition in sandbox instance but will have to pay for the full subscription based on the number of users (along with the currently running Standard edition subscription in production) A customer with Advanced edition on a production instance will be able to: - Use Standard edition for free: Customers will be able to install the Standard edition of that app and use it for free on their sandbox instance - Use Advanced edition for free: Customers will be able to install the Advanced edition of that app and use it for free on their sandbox instance |
Rate this page: