Supported products and types of links
This feature is now live in admin.atlassian.com
We've officially released an improved version of product links, which makes these docs obsolete. You can view it in admin.atlassian.com by going to Settings > Product links. The history and status of your previous link updates will still be there.
This page explains what products and types of links you can update.
Products
You can update links between Jira applications and Confluence.
Migration type
You can update links to destination products that were migrated using one of the Cloud Migration Assistants (Jira or Confluence) or the Jira site import (Jira). You need to use a different API endpoint depending on the migration type.
This feature doesn't update links after a cloud-to-cloud migration or any links that were originally pointing to a cloud product. We can only update links that were created as links to a Server or Data Center product, which was later migrated to cloud.
Limitations
In this EAP, you can only update links between products within one organization. Multiple sites within an organization are supported.
Types of links
With the exception of Confluence Macros, we consider the unsupported link types to have low priority and occurrence. We’re still adding more support, but some of these links might never be supported as they’re rarely used.
Jira applications
Supported links
Remote links to Jira issues
Remote links to Confluence pages
Links to Jira issues in the content added by users (description, comments)
- Jira source site URLs in the content added by users:
source-site/browsesource-site/secure/source-site/projects/source-site/issues/
Links to Confluence pages in the content added by users, including TinyURLs and blog posts:
Viewpage format:
<BaseURL>/pages/viewpage.action?pageId=<page_id>Editpage format:
<BaseURL>/pages/editpage.action?pageId=<page_id>Page title format:
<BaseURL>/wiki/spaces/<space_key>/pages/<page_id>/<page_title>Display format:
<BaseURL>/confluence/display/<spaceKey>/<pageName>Tiny URLs:
<Base URL>/x/ESYPIg
Links to Confluence that use the following URL (usually, this includes links to the space’s main page):
<Base URL>/display/*Links to customer portals in Jira Service Management
Unsupported links
Links in Jira custom fields (related issue)
Links in archived projects
Links to Jira attachments (related issue)
Links to Confluence in the Jira Sprint Report
Local links that become remote links after splitting an instance in cloud (related issue)
Confluence
Supported links
Links to Confluence pages in Confluence body:
Viewpage format:
<BaseURL>/pages/viewpage.action?pageId=<page_id>Editpage format:
<BaseURL>/pages/editpage.action?pageId=<page_id>Page title format:
<BaseURL>/wiki/spaces/<space_key>/pages/<page_id>/<page_title>Display format:
<BaseURL>/confluence/display/<spaceKey>/<pageName>Tiny URLs:
<Base URL>/x/ESYPIg
Links to Confluence attachments
Links to Confluence comments
Outgoing links in Page information
Remote links to Jira (not Jira Macros)
Unsupported links
Macros:
Some macros will be updated automatically during migration.
Jira Macros need to be updated separately by using Jira Macro Repair, which is available to Confluence admins.