Creating a project link with a new project

In the example below we have the following set-up in Jira:

To share versions/components from the Master (MAS) project, we will create a project link with project Linked Project 1 (LP1)

Navigate to the Administration interface of the Master project.
Go to the Version & Component Sync page
Click on Get Started
Make sure to thoroughly read the message in the pop-up modal before you click on continue

Select the project(s) you want to link to the Master project. Versions from Master will be propagated to selected project(s)
After selecting the desired projects to link to Master, click on Next:Synchronisation

Choose the desired synchronisation mode, you can choose between Simple or Advanced
In this example we used Simple synchronisation
After choosing your desired synchronisation mode, click on Next: Confirmation

Upon clicking on save, the app will:
- Start synchronising
- Shown an overview of the created project links and their current status
To edit or delete a existing project link click on the triple dot menu on the right of the project link

To provide you with insights in how the app works, this is what happens during synchronisation:
- Upon creating a project link between Master & Linked Project 1 the app checks whether there are versions present in Linked Project 1

The app recognises that version 1.0.0 does not exist in Linked Project 1
The app creates versions 1.0.0 in Linked Project 1
- Jira does not allow you to link a single version to multiple projects. Therefore the app needs to create ‘new’ versions in Linked Project 1
The app makes sure that upon creation of the ‘new’ version 1.0.0 in Linked Project 1 it is linked to version 1.0.0 in Master
This links ensures that any and all version changes to version 1.0.0 in the Master project are synchronised to version 1.0.0 in Linked Project 1

The app recognises that version 2.0.0 does not exist in Linked Project 1
The app creates versions 2.0.0 in Linked Project 1
- Jira does not allow you to link a single version to multiple projects. Therefore the app needs to create ‘new’ versions in Linked Project 1
The app makes sure that upon creation of the ‘new’ version 2.0.0 in Linked Project 1 it is linked to version 2.0.0 in Master
This links ensures that any and all version changes to version 2.0.0 in the Master project are synchronised to version 2.0.0 in Linked Project 1