What is link fixing?

After you migrate from Data Center to Cloud, your instances live under a different URL, that’s why all links between individual entities (Jira issues, Confluence pages) stop working, because they still use the previous URL.

This usually includes the following types of links:

• Local links within the migrated instance, pasted as URLs

• Remote links from other cloud apps to the migrated one

With Link fixing (previously known as product links), you can update such links in bulk. How often you’ll do it depends on your migration timeframe – you can wait until all instances are migrated or do it after every migration.

Example: Remote link from a Jira issue to a Confluence page

How links are updated and what you need

You update links on every Atlassian cloud app separately. Before you start, you should identify all Data Center instances that were originally linked to this app.

You will specify their migrated cloud equivalents as new destinations for existing links, and also tell us where they were migrated from, so we can find and update the right links.

What are link updates and how they work

When you update links, you run a link update on an Atlassian cloud app – you could also see it as a single task or a job. It updates all existing and compatible links found in the app. You’ll most likely need to run multiple link updates on every app, for example if:

• Some links weren’t updated the first time, because of errors

• You migrated new data into the app, which brought more links

• You migrated more instances to cloud, so you now have more links to update

You can run as many link updates as you need. The already updated links won’t be included.

Why local links need to be updated

Local links are links to entities within the same instance, so theoretically they shouldn’t need to be updated. That’s true if you created such links through built-in features, such as Link issue – they don’t need updates. However, your users most likely pasted many local links into comments or pages as URLs. Such links include the old base URL that needs to be updated.

In this case, the cloud app you’re updating and the new destination for existing links are the same.