Broken Confluence links after URL changed

Naziya Parveen
Contributor
October 12, 2024

Hello, had space at confluence ABC which was linked to jira XYZ.

ABC got deleted permanently by accident. I restored ABC space from XML export I had taken.  I have imported XML and also associated with Jira project while importing

 

issue is all the links in confluence takes me to jira but now since URL of this imported space is changed. All the links in Jira are broken.  Can you please suggest what can be done?

 

Thanks,

Naziya

3 answers

0 votes
Daniel Scott
I'm New Here
I'm New Here
Those new to the Atlassian Community have posted less than three times. Give them a warm welcome!
October 13, 2024

To re-establish the connection between Confluence and Jira, start by updating the Application Links.

Access Confluence administration and navigate to the "Application Links" section.

Review and update the existing link to Jira, deleting the old link if necessary and creating a new one with the correct URL.

Configure the authentication method, with OAuth being the recommended option.

Finally, test the new link to ensure it's working properly. This crucial step restores the foundational integration between the two systems.

More reference available in the below article.

 After a successful server to cloud migration URL links are broken in the new cloud instance | Confluence | Atlassian Documentation

 

Regards!

*********************************************


 

The issue you're facing is due to the change in the Confluence space's URL after restoring it from the XML export. Since the URLs have changed, all the links in Jira pointing to the old Confluence space URLs are now broken.

Here are some steps you can take to resolve this:

1. Update Jira Links in Bulk (if possible):

  • Find & Replace URLs in Jira: If your Jira instance supports SQL or API access, you may be able to run a bulk update to replace the old Confluence URLs with the new ones. You can:
    • Use Jira's REST API to search for issues that have links to the old Confluence space and update them with the new URL.
    • Alternatively, you can use a database query (with admin privileges) to update the URLs in Jira issues directly, though this is more advanced and risky.

2. Use Redirects (Web Server or Proxy Solution):

  • Create URL Redirects: Set up URL redirects on your web server (Nginx, Apache, etc.) to automatically forward users from the old URLs to the new ones. This can be a quick fix while you update Jira links over time.
  • This would involve redirecting requests from the old Confluence space URL pattern to the new one.

3. Update Links Manually:

  • Manual Jira Link Update: If the number of links in Jira is manageable, you can manually edit each issue in Jira to point to the correct new URL in Confluence.

4. Confluence Alias/Restore Original URL:

  • Set the URL in Confluence Back: If it's feasible and you still remember the old URL of the Confluence space, you can try to update the new Confluence space's base URL to match the original one (if not being used by another space). This way, the Jira links would not break.

5. Automation with Scripting:

  • Scripted Solution: If you have access to Jira's API, you can write a script to search for Jira issues containing links to the old Confluence space and update them with the new ones.
0 votes
Humashankar VJ
Rising Star
Rising Star
Rising Stars are recognized for providing high-quality answers to other users. Rising Stars receive a certificate of achievement and are on the path to becoming Community Leaders.
October 12, 2024

@Naziya Parveen 

To re-establish the connection between Confluence and Jira, start by updating the Application Links.

Access Confluence administration and navigate to the "Application Links" section.

Review and update the existing link to Jira, deleting the old link if necessary and creating a new one with the correct URL.

Configure the authentication method, with OAuth being the recommended option.

Finally, test the new link to ensure it's working properly. This crucial step restores the foundational integration between the two systems.

More reference available in the below article.

After a successful server to cloud migration URL links are broken in the new cloud instance | Confluence | Atlassian Documentation

Regards

0 votes
Humashankar VJ
Rising Star
Rising Star
Rising Stars are recognized for providing high-quality answers to other users. Rising Stars receive a certificate of achievement and are on the path to becoming Community Leaders.
October 12, 2024

Hi @Naziya Parveen 

Restoring a Confluence space from an XML export can cause integration issues with Jira due to URL changes, resulting in broken links.

To resolve this, update Confluence links to reflect the new URL and run the Jira Macro Repair Tool. Access this tool at - <YourSiteName>.atlassian.net/wiki/admin/jim-validator/view.action

Solved: Broken link between Jira Server and Confluence Clo... (atlassian.com)

By taking these steps, you'll ensure seamless integration between Jira and Confluence.

Additional help articles can be found here - Solved: Links broken after server rename (atlassian.com)

Hope this helps - Happy to help further!!
Thank you very much and have a great one!
Warm regards

Naziya Parveen
Contributor
October 12, 2024

Thank you @Humashankar VJ .

 

Above link took me for JIra macro validation. I have repaired all the macros. Please see the screen 1 .  However Jira has confluence URLs which points to older space which got deleted so all the links have can not find link. 

Error on Jira.png

 

Naziya Parveen
Contributor
October 12, 2024

Jira macro repair successful.png

 

Jira macro repair successful screen

Humashankar VJ
Rising Star
Rising Star
Rising Stars are recognized for providing high-quality answers to other users. Rising Stars receive a certificate of achievement and are on the path to becoming Community Leaders.
October 12, 2024

Hi @Naziya Parveen 

As a result, all these links are broken and cannot be found is what the bottom line ?

Regards

Naziya Parveen
Contributor
October 12, 2024

Correct, because this confluence space got deleted accidently. Would atlassian be able to help?

Like Humashankar VJ likes this
Humashankar VJ
Rising Star
Rising Star
Rising Stars are recognized for providing high-quality answers to other users. Rising Stars receive a certificate of achievement and are on the path to becoming Community Leaders.
October 12, 2024

Can you try the re-establish steps which i given and see that solves the issue.

 

Naziya Parveen
Contributor
October 12, 2024

Tried Jira macro repair again, all repair successful but it did not fix links of confluence from Jira.

Humashankar VJ
Rising Star
Rising Star
Rising Stars are recognized for providing high-quality answers to other users. Rising Stars receive a certificate of achievement and are on the path to becoming Community Leaders.
October 12, 2024

Thanks for checking the options - Let me try other options to get this fixed and keep you posted,

We also look forward to hearing from other community members, who may have alternative suggestions that could better address your requirements.

Can you consider creating one more thread from your end on this topic - to intake new suggestions from the other community members ?

Suggest an answer

Log in or Sign up to answer
DEPLOYMENT TYPE
CLOUD
PRODUCT PLAN
STANDARD
PERMISSIONS LEVEL
Product Admin
TAGS
AUG Leaders

Atlassian Community Events