• Products
  • Documentation
  • Resources

Supported products and types of links

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

Products

You can update links between Jira applications and Confluence.

Migration type

Migration options

You can’t update links related to products migrated using the Jira site import or the Migrate all data at once option of the Jira migration assistant. This applies to both the product you’re updating and the destination of links (for example, links from Confluence that go to a Jira instance migrated with the Jira site import). For these migration types, you’ll need to use REST API.

Learn more about using REST API

Deployment 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

You can only update links between products within one organization.

If your products are on multiple sites, but still within one org, this is supported.

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/browse

    • source-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.

Next steps

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

Additional Help