How to link user stories from one Jira instance with the user stories of another Jira instance?

Platform Notice: Cloud Only - This article only applies to Atlassian apps on the cloud platform.

Summary

This Kb covers how  user stories from one instance ex: https://ABCD.atlassian.net/ can be linked with user stories on another instance https://XYZ.atlassian.net

Environment

Jira Cloud

Solution

Before you start: You need Jira administrator access on both sites. Linking a Jira production site with its sandbox is not supported.

Work Items can be linked between two Jira instances using Application Links by following below steps:

1. In the source site, go to Jira Settings > Products

2. Select Application Links from the left-hand navigation

3. Select Create link

(Auto-migrated image: description temporarily unavailable)

4. Enter the base URL for the destination site.

(Auto-migrated image: description temporarily unavailable)

5. Select Next, then follow the on-screen configuration prompts.

6. Repeat this process in the destination site to link back to the source site so both sites reciprocally reference each other.

How do I know it worked?

Create or edit a work item link on any work item and check that you can choose between this site (Local) and the linked site (Remote). If the remote option appears and lets you search or paste the remote issue key, the application link is active.

For advanced integrations like automating work item synchronization or specific field updates, you can explore Jira Automation using REST APIs or third-party tools.

(Auto-migrated image: description temporarily unavailable)

Updated on September 23, 2026

Still need help?

The Atlassian Community is here for you.