Merge multiple Jira Cloud sites | Jira (2024)

Overview

There are four ways to move data to another Jira Cloud site. The method you choose will depend on your needs. To help you decide, this page describes each method and some of their respective limitations.

1. Perform a cloud-to-cloud migration (Recommended)
2. Use the Jira Cloud Migration Assistant via Jira Data Center
3. Merge sites in Jira Data Center and import into Jira Cloud manually
4. Use a CSV file to import issues

Perform a cloud-to-cloud migration

Cloud-to-cloud migration helps you move users and Jira Software and Jira Work Management projects from one cloud site to another. In a cloud-to-cloud migration, data is copied from one cloud site to another. You can use this method to combine data across two or more cloud sites, split a cloud site into multiple cloud sites, duplicate a cloud site, or copy specific projects from one cloud site to another.

Instructions

Prepare your sites for a cloud-to-cloud migration to reduce your chance of encountering any errors. Once you’re ready, follow these instructions to perform a cloud-to-cloud migration for Jira.

Limitations

• App data isn’t migrated.

• Some fields or configurations might not be supported. Before choosing this method, check what gets migrated with a cloud-to-cloud migration for Jira.

Use the Jira Cloud Migration Assistant via Jira Data Center

If you can’t perform a cloud-to-cloud migration, this is the next simplest way to maintain your setup and configurationand only requires downtime for one of your cloud sites.

This method requires setting up a Jira Data Center instance.You’ll need to create a backup of the data from your source cloud site and use theJira Cloud Migration Assistantto import that data intoyour destination cloud site.You can use this method to consolidate two cloud sites or move specific projects from one Jira Cloud site to another.

Instructions

Let's say you have two Jira Cloud sites:Jira Cloud AandJira Cloud B.You want to move all or some projects from Jira Cloud B to Jira Cloud A (your destination site) so you can have a single, consolidated cloud site.To do this you’ll need to:

1. Install the latest version of Jira Data Center. You can do this by generating a free trial license frommy.atlassian.com.Note that Jira Data Center trial licenses last for 30 days. If you need more time to complete your migration, licenses can be extended to 90 daysupon request.

2. Create a backupofJira Cloud B.This will contain the users and projects you want to import to Jira Cloud A. Note that team-managed projects aren’t available in Jira Data Center and will need to beconverted into company-managed projectsfor the backup to work using this method.

3. Import your datafrom Jira Cloud B to Jira Data Center.

4. Use theJira Cloud Migration Assistantto import your users and projects from Jira Data Center toJira Cloud A.

Limitations

• Team-managed projects aren’t available in Jira Data Center and will need to beconverted into company-managed projectsfor the backup to work using this method. Learn more about Jira Cloud backups

• App data isn’t migrated.

• Some fields or configurations might not be supported. Before choosing this method, check what gets migrated with the Jira Cloud Migration Assistant.

• Knowledge of how to install and set up a Jira Data Center instance is required.

Merge sites in Jira Data Center and import into Jira Cloud manually

This method requires setting up a Jira Data Center instance.You’ll need to create backups of all your Jira Cloud sites, merge the backups in Jira Data Center, then import the backups into your destination cloud site.

Instructions

Let's say you have two Jira Cloud sites:Jira Cloud AandJira Cloud B.You want to move all or some issues from Jira Cloud B into Jira Cloud A (your destination site) so you can have a single, consolidated cloud site.To do this you’ll need to:

1. Install the latest version of Jira Data Center. You can do this by generating a free trial license frommy.atlassian.com.Note that Jira Data Center trial licenses last for 30 days. If you need more time to complete your migration, licenses can be extended to 90 daysupon request.

2. Create a backupofJira Cloud B.This will contain the users and projects you want to import to Jira Cloud A. Note that team-managed projects aren’t available in Jira Data Center and will need to beconverted into company-managed projectsfor the backup to work using this method.

3. Import the backupofJira Cloud Bto Jira Data Center.

4. Create an XML backupof Jira Data Center, which will be used later to import projects.

5. Create a backupofJira Cloud A.

6. Import the backupofJira Cloud Ato Jira Data Center.

7. Use the XML backup you created in step 4 toimport the projectsyou want fromJira Cloud BtoJiraData Center. You should now have the projects you want from both Jira Cloud A and Jira Cloud B in Jira Data Center.

8. After successfully importing your chosen projects,create a backup of Jira Data Center.

9. Import that backup fileinto your destination Jira Cloud site.

Limitations

• Team-managed projects aren’t available in Jira Data Center and will need to beconverted into company-managed projectsfor the backup to work using this method. Learn more about Jira Cloud backups

• App data and users aren’t migrated.

• Knowledge of how to install and set up a Jira Data Center instance is required.

• Merging sites usually takes quite some time to complete, especially for large sites.

Use a CSV file to import issues

This method involves exporting and importing your issues via a CSV file. This method is recommended if you don’t have experience installing and setting up a Data Center instance, or if you only want to move a small number of issues.

Instructions

Let's say you have two Jira Cloud sites:Jira Cloud AandJira Cloud B.You want to move all or some issues from Jira Cloud B into Jira Cloud A (your destination site) so you can have a single, consolidated cloud site.To do this you’ll need to:

1. Search for all the issues in the requiredprojects inJira Cloud B andexport them as a CSV file.

2. Create the projects as empty in yourJira Cloud Asite.

3. Import the CSV fileto the projects in yourJira Cloud Asite.

Limitations

• This approach only merges issues, not projects.

• App data and users aren’t migrated.

• Before importing the CSV file, you'll need to recreate the project and set up the project's configurations (e.g., Workflow or Permission Scheme) on the destination site. This manual configuration may take some time.

• Issue History (e.g., timestamp of issue transitioned or issue updated) will not be retained.

• Additional steps are requiredto import attachments. Learn more about importing attachments into Jira Cloud using CSV External System Importer

• Links to Confluence pages under theMentioned Onsection in Jira issues will not be imported. To stay updated on this feature request or vote for it to be resolved, watch this feature request.

Was this helpful?

Yes

Provide feedback about this article