Showing results for 
Search instead for 
Did you mean: 
Sign up Log in

Issue links broken after Jira Software migration to cloud

Bo Bøgvald January 25, 2023

Anyone knows how to fix broken issue links after migration of Jira Software to cloud?

I am testing migration one of our Jira Software instances to cloud. After migration and after recreating application links to Jira ServiceManagement and another Jira Software instance, I experience that links only works one-way. From the migrated Jira Software they work fine, but from ServiceManagement and the other Jira Software they are broken.

I guess it is because the Jira Software that has been migrated to cloud has got some sort of new ID, and therefore ServiceManagement and the other Jira Software does not "know" that the cloud instance has replaced the server instance.

Atlassian support is referring to some generic processes that is not specific enough for me to fix the issue:

  1. You can recreate them using REST APIs as mentioned here group issue links
  2. Or you can use the CSV import method to just import the links after the issues were migrated.

Any help is highly appreciated.


Best Regards


3 answers

1 accepted

Suggest an answer

Log in or Sign up to answer
1 vote
Answer accepted
Ralf Becker January 25, 2023

We had the same issue, but there is a conveniant solution to this: the Atlassian-Support will do this for you. Keep Googling: there is an help article with SQL-queries you have to run on your Server-instance and send these results to the support. They will do the rest. Migrated 18k tickets and 36k pages half a year before, just found 1 or 2 cases where it did not work out. 

Bo Bøgvald January 25, 2023

Thank you very much, Ralf. Exactly what I need. I will Google, and discuss with Atlassian.

Paul Hecker January 25, 2023

Hi Bo,
You have probably already found the relevant information, but for the benefit of others migrating Confluence to cloud, please refer to the information below.

Once the migration of Confluence to cloud completes, the first step is to run the Macro Repair Tool. It may require running the tool several times until the tool does not prompt for any more repairs.  Running until you get an error free result is needed to identify and correct the links within the tool's repair scope.

Using the Jira Macro Repair

As of January 2023, there is a know bug you should be aware of concerning the Macro Repair Tool. If you find that the Macro Repair Tool keeps prompting for the same repairs, wait 60 minutes to allow for any backend processing that might be running to complete, and try running the Macro Repair Tool again. If it is still prompting to make the same repair, please open a Support ticket with Atlassian. If you have been working with an Atlassian Cloud Migration Manager (CMM), you would need to follow their instructions on opening a Problem Ticket associated with the migration to get the proper assistance.

CONFCLOUD-73050 - Jira Macro Repair needs to be run multiple times after migration

Once the Macro Repair has completed, or while Atlassian Support reviews the macro repair results as noted above, gather the information in the support document referenced below and open a support ticket \ problem ticket with Atlassian Support to run the Confluence Link Repair.  Atlassian will need that information to run their link repairs.

After a successful Server to Cloud Migration, URL links are broken in the new Cloud instance

Please keep in mind that the link repair scripts take a significant amount of time to run, but Atlassian Support will update you when they start the link repairs and usually provide an estimate on when the repairs should complete.

I hope this information is helpful.


Like # people like this
Bo Bøgvald January 25, 2023

Thanks much, Paul. Now, we are not migrating Confluence, only Jira Software, leaving Confluence and Jira ServiceManagement on-premise. Do you have similar information about how to repair broken issue links between:

  • Jira Software cloud and Jira Service Management on-premise
  • Jira Software cloud and Confluence on-premise 
  • Jira Software cloud and other existing Jira Software cloud. 

All help is highly appreciated.

Paul Hecker January 27, 2023

I have some information on Jira link repair, but not much.  This was related from one of the Cloud Migration Engineers as part of a similar discussion.

It does not sound like it's helpful, but the Confluence link repair process does make "some" repairs in Jira.

Atlassian is working on enhancements to the post-migration link repair process and they do repair the Jira link as well on a few scenarios as mentioned above.

Also, for the Jira Issues Macro, they have the Jira Macro Repair Tool for Confluence (, which is a tool to fix all Jira Issues Macros after the migration to Cloud.

For reference, you can find a Glossary of Types of Links Resolved by Atlassian Support (

I hope some of that is helpful.



Bo Bøgvald January 30, 2023

Thanks for the additional information. I am glad to see that Atlassian is actually working on improving this! As for the repair tool, it seems like it is only available in the cloud, and thus it is not possible to use it on our on-premise installation, I am afraid.

Like IT OPUSG likes this
1 vote
Janco Hoekstra January 25, 2023

Hi Bo

I had a problem like that and corrected the links over the rest API.
For this to work, you'll need to find a way to map the old linked issues to the cloud once.

In my case, I wrote a script in python, that looked up the issue link in the old on-prem and used a unique identifier (in my case a cf in the target issue). Then on cloud I let the script search for this identifier and changed the false link (cloud source issue) to be corrected to point to the found target issue in cloud.

I hope this will help.

Bo Bøgvald January 25, 2023

Thanks Janco. I will keep you advice in mind in case I cannot find any other solution. But I would prefer to avoid doing my own scripts if possible.

0 votes
Salim Richa January 25, 2023

Did you try to migrate all the issues from the on-prem to the cloud?

Bo Bøgvald January 25, 2023

We cannot migrate ServiceManagement due to contractual and GDPR considerations. The other Jira Software is in the cloud already. Still links break.

Like Salim Richa likes this
AUG Leaders

Atlassian Community Events