Submit your Data Center app to the Atlassian Marketplace

Prepare to share or sell your Data Center (DC) app on the Atlassian Marketplace.

Before you publish your app, you'll need to:

1. Start, complete, and submit the technical review for your Data Center app.
2. Test your app performance at scale and share the results in the comment section of your technical review ticket.
3. Complete and submit the DC Security Questionnaire form in your ECOHELP ticket.
4. Check your app descriptor.
5. Create your Marketplace listing. You'll need the technical review ticket created in Step 1.

Before your Data Center app launches on Marketplace, both your technical review and Marketplace listing need to be approved.

If you have any questions about Data Center or Marketplace, please reach out to our team.

1. Complete the technical review

To list your Data Center app on Marketplace, you need to complete a technical review.

The technical review helps us make sure your app meets the performance and stability requirements of our largest Data Center customers.

Start your technical review ticket.

Within the technical review ticket:

1. Complete the form with your app's support, functionality, and security details.
2. Submit the completed review form.
3. Fill out the app-specific security questionnaire.
4. Test your app's performance and add the results to the ticket.

You’ll hear from our team within 5–10 business days.

If we have any questions about your submission, we'll ask you in this ticket.

While your technical review is being checked, you're welcome to start your Marketplace listing (Step 4). In the Marketplace listing, you'll be asked to provide your Technical review work item key. This is the tracking number on your technical review ticket. For example, ECOHELP-123.

If your app works with more than one Atlassian product, you'll need to complete a technical review ticket for each.

Learn more about the Data Center app approval process.

Test your app against major databases:

In your technical review there's a section related to testing your app against the major databases:

• PostgreSQL
• MySQL
• Microsoft SQL Server, and
• Oracle

Testing against the supported databases is still required even if you access databases directly or through active objects. It's important to test functionality that involves any operation with the database.

If your app does not access databases directly or through active objects:

• Check the successful installation of the application
• You do not need to run Performance and Scale tests against all databases
• You need to confirm that your plugin can work independently against the database type

For non-installable apps

If you have a non-installable Data Center app, you also need to submit a technical review.

Some differences are:

• Security checks are not needed
• Additional questions about app performance are asked in the technical review ticket comments
• If your app affects product performance, you may be asked to run tests and share the results

For multiproduct-supported apps

If your app supports multiple Atlassian parent products, select the My app supports multiple products option for the Atlassian Product field during the technical review creation stage.

To initiate the technical review process:

1. Submit the following forms:
   • Initial/Annual app submission form for multiproduct-supported apps
   • Product-specific questions form
   • DC Security Questionnaire
2. Provide the performance and scaling test results for each parent product your app supports and share them in the comment section of your technical review ticket.
3. Provide Lucene index test (for Jira/Jira Service Management apps only).

Annual review for Data Center apps

Once your app's initial technical review is approved, each year you'll need to submit an annual review.

You can access and complete this within your technical review ticket.

In the annual review, you'll need to:

• Outline any functionality changes in your app
• Run performance, scale tests and security checks
• Share your results in the technical review ticket

Two months prior to your Annual Review date, a new annual review ticket will be created, and you will receive an email reminder to:

• Complete the annual review survey via your new annual review ticket, referencing the previously approved review tickets for this app.
• You must use the latest version of your app for all required tests.

If the annual review due date passes without a response, the annual review ticket will automatically move to the removal queue, and the app will be hidden from the Marketplace. In this case, the Partner will need to submit a new technical review ticket and complete the review process from the beginning. Once the review is approved, the app's visibility will be restored.

2. Test your app's performance at scale

After creating your technical review ticket in Step 1, use it to add details about how your app performs at scale.

It's important to check how your app handles the types of user load our biggest customers typically see.

Use the Data Center App Performance Toolkit

For performance and scale testing we recommend you use the Data Center App Performance Toolkit.

Each Atlassian product has a different toolkit:

• Jira
• Jira Service Management
• Confluence
• Bitbucket
• Crowd
• Bamboo

To run the toolkit:

1. Install the relevant toolkit on a testing host.
2. Add your app-specific actions to the toolkit.
3. Set up an enterprise-scale Data Center deployment on AWS.
4. Run the tool to collect performance and scale data.
5. Document the results on your technical review ticket.

Use your own testing environment

You can use your own testing environment if:

• You already have one
• You prefer to use a different set of testing tools

Test and document how your application performs in a Data Center deployment with one, two, and four application nodes.

Learn more about performance and scale testing requirements.

Lucene index test for JIRA

If you're submitting a Jira or Jira Service Management app, you'll need to conduct a Lucene Index timing test.

This involves conducting a foreground re-index on a:

• Single-node Data Center deployment (with your app installed)
• Dataset that has 1M issues

We recommend the Data Center App Performance Toolkit to conduct this test. It ships with an appropriate dataset for testing. Without an app installed, it takes about 50minutes.

Upon completing the index:

1. Screenshot the acknowledgment screen displaying the re-index time.
2. Attach the screenshot to your technical review ticket.

3. Security check

Complete and submit the DC Security Questionnaire form in your ECOHELP ticket.

4. Check your app descriptor

Before submitting your app to the Marketplace, ensure that your app descriptor (atlassian-plugin.xml) includes Data Center compatibility.

The plugin-info section will need to contain:

1
2
<param name="atlassian-data-center-status">compatible</param>
<param name="atlassian-data-center-compatible">true</param>

• The atlassian-data-center-status parameter indicates to Marketplace and Universal Plugin Manager (UPM) that you've submitted an app for technical review.
• The atlassian-data-center-compatible parameter was previously used to indicate Data Center compatibility. It's included for backward compatibility with older UPM versions.

Here's an example of a generic plugin-info block with these parameters:

1
2
<plugin-info>
    <description>${project.description}</description>
    <version>${project.version}</version>
    <vendor name="${project.organization.name}" url="${project.organization.url}" />
    <param name="atlassian-data-center-status">compatible</param>
    <param name="atlassian-data-center-compatible">true</param>
</plugin-info>

5. Start your Marketplace submission

After starting your technical review, you can start your app's Atlassian Marketplace listing.

Your Data Center app Marketplace submission:

• Can still be drafted while your technical review is being approved
• Will require an approved technical review before being launched
• Can take 5-10 business days for our team to process
• Make sure your app complies with Security requirements for Data Center apps

How to start your Marketplace submission:

1. Log in to the Atlassian Marketplace with your partner account.
2. Select Publish a new app from the profile menu in the upper right.
3. Select the Vendor account you'd like associated as the app owner.
4. Upload your App file.
5. Enter your App name.
6. Select Next: Make public.
7. Next, follow the screens to complete your Marketplace submission. You'll be asked to provide your Technical review work item key from the review ticket.

If you have any questions, please reach out to our team.

How to list the Data Center version of your app to Marketplace:

1. Log in to the Atlassian Marketplace with your partner account.
2. Select Manage vendor account from the profile menu in the upper right.
3. Select the name of the app you're adding a Data Center-compatible version for.
4. Select Create version.
5. Upload your artefact.
6. Follow the steps to submit your app. Provide a link to your technical review ticket.

Data Center updates

We continue to develop and release:

• Performance Testing tools
• Benchmarks on performance
• Guidelines on monitoring
• Guidelines on improving the performance of Atlassian Data Center products

With any updates, we'll make the relevant changes to our processes and documentation. It's our priority that you have the latest and most accurate guidance.