We’re renaming ‘products’ to ‘apps’

Atlassian 'products’ are now ‘apps’. You may see both terms used across our documentation as we roll out this terminology change. Here’s why we’re making this change

Supported Atlassian apps and types of links

This page explains what Atlassian apps and types of links you can update.

Supported apps and migration types

Here’s a summary of what’s supported.

Atlassian apps

  • Jira applications

  • Confluence

Migration type

  • From Data Center to Cloud

  • Between Cloud sites

Federation: Jira Data Center

When you split a single Jira Server or Data Center instance into multiple instances in cloud, issue links that were previously local will no longer exist. You can recreate them as remote links and update to their new destinations. This is supported only with REST API. Learn how to update links to federated instances

You can recreate your links only for 2 weeks after the migration. Afterwards, the migration data that we sue to identify those links is deleted for privacy reasons.

Limitations and recommendations

Here is some important information:

  • You can only update links between cloud apps within one organization. If your apps are on multiple sites, but still within one org, this is supported.

  • When updating links from Jira to Confluence, we recommend that you do it only after you’re sure that your Confluence migration (partial or full) was successful, and you won’t have to delete and re-migrate any data. Many Confluence links are updated based on IDs (not just replacing URLs), so they will be different after every re-migration of the same data. When you re-migrate, the previously updated links in Jira keep using the old IDs and can’t be updated again to the new ones.

We fix the majority of Jira and Confluence links, with some exceptions. You can review the list below for more details and examples of links.

In Jira applications

Type

Sample links

Jira-specific

Links to Jira work items (local and remote)

  • <BaseURL>/jira/core/projects/<ProjectKey>/issues

  • <BaseURL>/jira/software/c/projects/<ProjectKey>/issues

  • <BaseURL>/jira/software/projects/<ProjectKey>/issues

  • <BaseURL>/jira/core/projects/<ProjectKey>/issues/<IssueKey>

  • <BaseURL>/jira/core/projects/<ProjectKey>/issues/<IssueKey>?jql=<JQL>

  • <BaseURL>/jira/core/projects/<ProjectKey>/list

  • <BaseURL>/jira/core/projects/<ProjectKey>/list?selectedIssue=<IssueKey>

  • <BaseURL>/jira/core/projects/<ProjectKey>/list?filter=<filterS>

Links to Jira work items in user-generated content (description, comments)

Jira source site URLs in the content added by users

  • source-site/browse

  • source-site/secure/

  • source-site/projects/

  • source-site/issues/

Links to boards and backlogs

  • <BaseURL>/jira/core/projects/<ProjectKey>/board

  • <BaseURL>/jira/core/projects/<ProjectKey>/board?selectedIssue=<IssueKey>

  • <BaseURL>/jira/core/projects/<ProjectKey>/board?filter=<filter>

  • <BaseURL>/jira/servicedesk/projects/<ProjectKey>/boards/<BoardID>

  • <BaseURL>/jira/software/projects/<ProjectKey>/boards/<BoardID>/backlog

  • <BaseURL>/jira/software/projects/<ProjectKey>/boards/<BoardID>/backlog?selectedIssue=<IssueKey>

Local links that become remote links after splitting an instance in cloud (federation)

-

Links to Jira attachments

  • <BaseURL>/secure/attachment/92392

Confluence-specific

Links to Confluence pages

  • <BaseURL>/pages/viewpage.action?pageId=<PageID>

  • <BaseURL>/pages/editpage.action?pageId=<PageID>

  • <BaseURL>/wiki/spaces/<SpaceKey>/pages/<PageID>/<page_title>

  • <BaseURL>/confluence/display/<spaceKey>/<pageName>

  • <BaseURL>/x/ESYPIg

  • <BaseURL>/spaces/<SpaceKey>/pages/<PageID>

  • <BaseURL>/spaces/<SpaceKey>/pages/<PageID>/<PageTitle>

  • <BaseURL>/spaces/<SpaceKey>/pages/<PageID>/<PageTitle>?focusedCommentId=<CommentId>

  • <BaseURL>/spaces/<SpaceKey>/pages/<PageID>/<PageTitle>#<AnchoredHeading>

  • <BaseURL>/x/<HashedKey>?<Value>

  • <BaseURL>/spaces/<SpaceKey>/pages/<PageID>/<PageTitle>#:~:text=<HighlightedText>

  • <BaseURL>/spaces/<SpaceKey>/pages/edit-v2/<PageID>

  • <BaseURL>/spaces/<SpaceKey>/pages/edit-v2/<PageID>?focusedCommentId=<CommentId>

Links to Confluence pages in user-generated content, including TinyURLs and blog posts

Links to Confluence blogs

  • <BaseURL>/spaces/<SpaceKey>/blog

  • <BaseURL>/spaces/<SpaceKey>/blog/<Year>/<Month>/<Date>

  • <BaseURL>/spaces/<SpaceKey>/blog/<Year>/<Month>/<Date>/<BlogID>/<BlogTitle>

  • <BaseURL>/spaces/<SpaceKey>/blog/2024/10/25/<BlogID>

  • <BaseURL>/x/<HashedString>

  • <BaseURL>/spaces/<SpaceKey>/blog/<Year>/<Month>/<Date>/<BlogID>/Blog+1#<AnchoredHeading>

  • <BaseURL>/spaces/<SpaceKey>/blog/<Year>/<Month>/<Date>/<BlogID>/Blog+1#:~:text=<HighlightedText>

  • <BaseURL>/spaces/<SpaceKey>/blog/<Year>/<Month>/<Date>/<BlogID>/<BlogTitle>?focusedCommentId=<CommentId>

  • <BaseURL>/spaces/<SpaceKey>/blog/<Year>/<Month>/<Date>/<BlogID>/Blog+1?focusedCommentId=<CommentId>

  • <BaseURL>/spaces/<SpaceKey>/blog/edit-v2/<BlogID>

  • <BaseURL>/spaces/<SpaceKey>/blog/edit-v2/<BlogID>?focusedCommentId=<CommentId>

Links to Confluence that use the following URL (usually, this includes links to the space’s main page)

  • <Base URL>/display/*

Links to Confluence attachments

  • <BaseURL>/download/attachments/<PageID>/<ImageName>

Jira Service Management-specific

Links to service projects and requests (local and remote)

  • <BaseURL>/servicedesk/customer/portal/<serviceDeskId>/<issueKey>

  • See other examples in projects and work items above.

Links to customer portals

  • <BaseURL>/servicedesk/customer/portal/<serviceDeskId>/<issueKey>

  • <BaseURL>/servicedesk/customer/portal/<PortalSettingId>

  • <BaseURL>/servicedesk/customer/portal/<PortalSettingId>/group/<GroupID>

  • <BaseURL>/servicedesk/customer/portal/<PortalSettingId>/group/<GroupID>/create/<RequestId>

  • <BaseURL>/servicedesk/customer/portal/<PortalSettingId>/<IssueKey>

  • <BaseURL>/servicedesk/customer/portals

Links to queues

  • <BaseURL>/jira/servicedesk/projects/<ProjectKey>/queues/custom/<QueueId>

  • <BaseURL>/jira/servicedesk/projects/<ProjectKey>/queues/issue/<IssueKey>

Links to customers and notification logs

  • <BaseURL>/jira/servicedesk/projects/<ProjectKey>/customers

  • <BaseURL>/jira/servicedesk/projects/<ProjectKey>/notification-logs

  • <BaseURL>/jira/servicedesk/projects/<ProjectKey>/queues/custom/<QueueId>/<IssueKey>

Unsupported links

  • Links in archived projects

  • Links to Confluence in the Jira Sprint Report

  • Links in or to archived issues

In Confluence

Type

Sample links

Confluence-specific

Base URL

<BaseURL>

Links to spaces

<BaseURL>/spaces/<SpaceKey>

Links to pages

  • <BaseURL>/pages/viewpage.action?pageId=<PageID>

  • <BaseURL>/pages/editpage.action?pageId=<PageID>

  • <BaseURL>/wiki/spaces/<SpaceKey>/pages/<PageID>/<page_title>

  • <BaseURL>/confluence/display/<spaceKey>/<pageName>

  • <Base URL>/x/ESYPIg

  • <BaseURL>/spaces/<SpaceKey>/pages/<PageID>

  • <BaseURL>/spaces/<SpaceKey>/pages/<PageID>/<PageTitle>

  • <BaseURL>/spaces/<SpaceKey>/pages/<PageID>/<PageTitle>?focusedCommentId=<CommentId>

  • <BaseURL>/spaces/<SpaceKey>/pages/<PageID>/<PageTitle>#<SELECTED-HEADING>

  • <BaseURL>/x/<HASHED_KEY>?<Value>

  • <BaseURL>/spaces/<SpaceKey>/pages/<PageID>/<PageTitle>#:~:text=<SELECTED-TEXT>

  • <BaseURL>/spaces/<SpaceKey>/pages/edit-v2/<PageID>

  • <BaseURL>/spaces/<SpaceKey>/pages/edit-v2/<PageID>?focusedCommentId=<CommentId>

Links to blogs

  • <BaseURL>/spaces/<SpaceKey>/blog

  • <BaseURL>/spaces/<SpaceKey>/blog/<Year>/<Month>/<Date>

  • <BaseURL>/spaces/<SpaceKey>/blog/<Year>/<Month>/<Date>/<BlogID>/<BlogTitle>

  • <BaseURL>/spaces/<SpaceKey>/blog/2024/10/25/<BlogID>

  • <BaseURL>/x/<HashedString>

  • <BaseURL>/spaces/<SpaceKey>/blog/<Year>/<Month>/<Date>/<BlogID>/Blog+1#<AnchoredHeading>

  • <BaseURL>/spaces/<SpaceKey>/blog/<Year>/<Month>/<Date>/<BlogID>/Blog+1#:~:text=<HighlightedText>

  • <BaseURL>/spaces/<SpaceKey>/blog/<Year>/<Month>/<Date>/<BlogID>/<BlogTitle>?focusedCommentId=<CommentId>

  • <BaseURL>/spaces/<SpaceKey>/blog/<Year>/<Month>/<Date>/<BlogID>/Blog+1?focusedCommentId=<CommentId>

  • <BaseURL>/spaces/<SpaceKey>/blog/edit-v2/<BlogID>

  • <BaseURL>/spaces/<SpaceKey>/blog/edit-v2/<BlogID>?focusedCommentId=<CommentId>

Links to attachments

  • <BaseURL>/download/attachments/<PageID>/<ImageName>

Links to thumbnails

  • <BaseURL>/download/thumbnails/<PageID>/<ImageName>

Outgoing links in Page information

-

Macros:

  • Task report

  • Create from template - space and global templates

  • Content by label

  • Page properties

-

Jira-specific

Base URL

  • <BaseURL>

Links to Jira work items

  • <BaseURL>/jira/core/projects/<ProjectKey>/issues

  • <BaseURL>/jira/software/c/projects/<ProjectKey>/issues

  • <BaseURL>/jira/software/projects/<ProjectKey>/issues

  • <BaseURL>/jira/core/projects/<ProjectKey>/issues/<IssueKey>

  • <BaseURL>/jira/core/projects/<ProjectKey>/issues/<IssueKey>?jql=<JQL>

  • <BaseURL>/jira/core/projects/<ProjectKey>/list

  • <BaseURL>/jira/core/projects/<ProjectKey>/list?selectedIssue=<IssueKey>

  • <BaseURL>/jira/core/projects/<ProjectKey>/list?filter=<filterS>

Links to boards and backlogs

  • <BaseURL>/jira/core/projects/<ProjectKey>/board

  • <BaseURL>/jira/core/projects/<ProjectKey>/board?selectedIssue=<IssueKey>

  • <BaseURL>/jira/core/projects/<ProjectKey>/board?filter=<filter>

  • <BaseURL>/jira/servicedesk/projects/<ProjectKey>/boards/<BoardID>

  • <BaseURL>/jira/software/projects/<ProjectKey>/boards/<BoardID>/backlog

  • <BaseURL>/jira/software/projects/<ProjectKey>/boards/<BoardID>/backlog?selectedIssue=<IssueKey>

Jira Service Management-specific

Links to service projects and requests (local and remote)

  • <BaseURL>/servicedesk/customer/portal/<serviceDeskId>/<issueKey>

  • See other examples in projects and issues above.

Links to customer portals

  • <BaseURL>/servicedesk/customer/portal/<serviceDeskId>/<issueKey>

  • <BaseURL>/servicedesk/customer/portal/<PortalSettingId>

  • <BaseURL>/servicedesk/customer/portal/<PortalSettingId>/group/<GROUP_ID>

  • <BaseURL>/servicedesk/customer/portal/<PortalSettingId>/group/<GROUP_ID>/create/<RequestId>

  • <BaseURL>/servicedesk/customer/portal/<PortalSettingId>/<IssueKey>

  • <BaseURL>/servicedesk/customer/portals

Links to queues

  • <BaseURL>/jira/servicedesk/projects/<ProjectKey>/queues/custom/<QueueId>

Links to customers and notification logs

  • <BaseURL>/jira/servicedesk/projects/<ProjectKey>/customers

  • <BaseURL>/jira/servicedesk/projects/<ProjectKey>/notification-logs

  • <BaseURL>/jira/servicedesk/projects/<ProjectKey>/queues/custom/<QueueId>/<IssueKey>

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. It can upDate most Jira macros, with the following exceptions:

      • Jira macros that were split into multiple instances in cloud (federation)

      • JQL in Jira macros

    • Third-party macros


Next steps

When you’re ready, start updating your links. Learn how to update links after migration

 

Still need help?

The Atlassian Community is here for you.