nav[aria-label="Primary Navigation"] { padding: 0; & ul { list-style: none; width: 100%; display: flex; flex-direction: row; justify-content: start; align-items: start; gap: 30px; padding: 0; & li { margin: 0; } & ul li { list-style: none; } } }

Broken Confluence links after URL changed

Naziya Parveen

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

Accepted answers

All comments

Humashankar VJ

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

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

Jira macro repair successful.png

Jira macro repair successful screen

Humashankar VJ

Hi @Naziya Parveen

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

Regards

Humashankar VJ

@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

Daniel Scott_bp0m67

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 Docume ntation

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.

Welcome!

It looks like you're new here. Sign in or register to get started.

Quick Links

Find more posts tagged with

confluence

cloud

jira-software

confluence-cloud