/
Cloud to Cloud migration

Cloud to Cloud migration

The only supported approach for migrating Advanced Links between Cloud instances is to transfer the data manually.

The migration consists of the following steps:

  1. Export the Advanced Links configuration

Export the Advanced Links configuration from the source instance as a JSON file by following this guide: Migration, Import & Export

  1. Configure Storage Link types

Associate each Advanced Link type with a corresponding Jira system link by configuring a Storage Link. This ensures that every Advanced Link is duplicated as a native Jira issue link, allowing the relationships to be migrated using Jira's CSV import.

image-20260217-090636.png

  1. Export the issues

Export all required issues from the source instance via CSV. Make sure that the exported data includes the Jira system links created by the Storage Link configuration.

  1. Import the Advanced Links configuration

Import the previously exported Advanced Links configuration JSON into the target instance.

  1. Import the issues

Import the issues into the target instance using External System Import (CSV). During field mapping, make sure to map the corresponding Jira link type.

image-20260217-091316.png

  1. Migrate Jira system links back to Advanced Links

After importing both the issues and the Advanced Links configuration, convert the Jira system links back into Advanced Links.

  • Search for the required Jira link type using JQL.

  • Select the source (Jira system link) and the target (Advanced Link).

  • Use the Jira link type name, not its inward or outward description.

  • If you do not want the Jira system links to remain after the migration, clear the Keep source links checkbox.

image-20260213-133608.png
image-20260213-134023.png

The JQL used in the migration dialog may be cached.

If the expected links are not found, try making the query more specific by adding an additional condition, for example:

  • project

  • created date

  • issue type

This forces Jira to execute a fresh search.

  1. Verify whether any Jira system links remain

After the migration, you can verify whether any Jira system links still need to be converted.

  1. Go to Jira Settings -> Work item linking.

  2. Click Delete next to the relevant Jira link type.

Jira will display how many issues are currently using that link type.

  • If the number is 0, all links have already been migrated.

  • If the number is greater than 0, there are still Jira system links that need to be migrated.

There is no need to actually delete the link type. This dialog is only used to check how many issues are still using it.