• Products
  • Documentation
  • Resources

Moving your Marketplace apps data to another location

Data residency for Marketplace apps is currently in beta.

An app, sometimes called an add-on or plugin, is an installable component that supplements or enhances the functionality of a product, such as Jira Software, Jira Service Management, Jira Work Management, and Confluence. An app is always linked, associated or subscribed to a product. You can find all the available apps in the Atlassian Marketplace.

Data residency gives customers control over where they store their data. Only some Marketplace apps support data residency, which means moving and pinning the app from one location to another. If an app supports data migration and pinning, you can request that we move your app data and store it within the same location as your host product. Hence, apps will only be migrated after the product has been hosted in a location.

For example, say you have an app installed for Confluence and would like to migrate the in-scope product and app data to the USA. First, you must migrate your Confluence instance to the USA; then, you can separately request app data to be moved to the USA.

Only some apps support data residency, you can check which apps support it on admin.atlassian.com. Before you request a data residency move for apps, you should understand the migration support status for an app.

What are app statuses?

Many apps on the Marketplace offer the ability to pin and move data between locations. Currently, we have four app statuses:

  • Pinned

  • Eligible

  • Not eligible

  • No action available

Pinned

These apps are already pinned to the product location and store data in the same location. In some cases, the apps can also be pinned during installation; they don't need to be migrated.
For example, say you have Confluence pinned to the USA location and install a new app supporting data pinning to the USA. If the app is installed after the product is pinned, it is also moved to the USA location. Therefore this app would show up in the Pinned tab.

Eligible

For an app to be eligible for a data residency move, it must support the following:

  • data pinning in the same location as the host product

  • data migration between locations

  • not currently pinned to the same location as the host product

If the app supports only one or none of the above, then the app is considered to be not eligible. Only eligible apps can moved to their product location.

Not eligible

If you have apps that are not eligible for data residency move, it can be because:

  • They don't support data residency to the same location as the host product

  • They currently don't support data residency migration

No action available

If you have apps that have no action available for a data residency move, it’s because some app partners declare that their apps don't need to be pinned or migrated as:

  • their apps exclusively store data within the Atlassian product or

  • their apps don't store any data

To learn about an app's data residency policy, view the Privacy and Security tab on its Atlassian Marketplace listing or review its privacy policy.

How do we manage data residency moves for Marketplace apps?

We offer our Marketplace partners a variety of tools to help them support data residency.

When you request that an app be pinned to a new location, your request is sent to the third-party Marketplace partner who operates the app. Atlassian forwards your data residency move request to Marketplace partner who is responsible for migrating the app data. The third-party partner must be onboarded on the Developer platform to support an app migration.
Available data residency locations may vary by Marketplace app. While Atlassian supports multiple regions, each third-party Marketplace Partner decides which regions to support for the apps they build and operate.

How does a data residency move for Marketplace apps affect your product?

While the Marketplace partners are moving your eligible app data to the requested location, the host product will be offline, and your users won't be able to access it. This move can be scheduled up to 3 days in advance and it takes up to 24 hours for all apps to move. You should, however, plan for your product to be offline for 24 hours during an app move. When you request data residency move for apps, you select a 24-hour move window. We provide this 24-hour window to our Marketplace partners to move the app. They will plan to complete your move during this 24-hour window, but we can't say precisely when, as it depends on the Marketplace partner. Your product and its apps will be online as soon as the move is complete.

Request a data residency move for apps

Once your product data has moved to a location, you can request to move eligible app data to the same product location.

If your apps are eligible to move data to the host product location to support data residency, you can request that they be moved to their product location and pinned there.

To request a data residency move for apps:

  1. Go to admin.atlassian.com. Select your organization if you have more than one.

  2. Select Security > Data residency.

  3. In the data residency table, go to App Status and find any Eligible apps to move.

  4. Go to the Actions column and select Move apps.

In case you don't see the action Move apps available, you can go to View details to check more about your app details

This will open the request workflow where you can:

  • review the apps which will be eligible to be pinned and held in the same product location

  • enter the 24-hour window when you'd like the eligible apps to move.

Data residency move for Marketplace apps must be requested at least three days in advance.

Cancel a data residency move for apps

You can cancel a data residency move for apps if the app's status is MOVE SCHEDULED.

To cancel a data residency move:

  1. Go to admin.atlassian.com. Select your organization if you have more than one.

  2. Select Security > Data residency.

  3. Find the host product of the apps in the data residency table.

  4. Go to Actions and select Cancel move.

After we cancel the move, this status will be replaced with ELIGIBLE apps.

What if the apps fail to move to a location?

All eligible apps will move together in a single app migration. Once the app migration is complete, the status of the successfully migrated apps will change from ELIGIBLE to PINNED. Sometimes, you may notice that an app has failed to migrate data to a new region. The app's status that has failed the migration will again be ELIGIBLE to move. You can request the app migration again or reach out to the Marketplace partner to understand the reason behind the failure.

To check the status of apps during data migration:

  1. Go to admin.atlassian.com. Select your organization if you have more than one.

  2. Select Security > Data residency.

  3. Find the app in the data residency table.

  4. Go to Actions and select View details.

  5. Go to App details and select the Eligible tab.

When the status of the app migration is still MOVE-IN-PROGRESS, you can see the live status of MOVE-IN-PROGRESS or PROBLEM OCCURRED in the Eligible tab, but only until the migration is completed.

 

Additional Help