Skip to main content
Skip table of contents

Create a Synchronization

Backbone Issue Sync allows you to integrate two Jira projects to synchronize issues.

Scope of a synchronization

Synchronizations are always configured on a project-by-project basis, always between two projects.

However, you can create multiple synchronizations per project. So if you want to connect one project with multiple projects, you can simply create multiple synchronizations for a project.

Data transmission protocol

Backbone uses the official Jira REST API in order to access both Jira projects which it integrates. If you provide a HTTPS URL when you setup the synchronization, Backbone will use an encrypted channel in order to communicate with JIRA.


Configuration

You can sync two projects on the same instance or on a different instance.

Synchronize two Jira projects on the same instance 

  1. Firstly, open the project that you want to synchronize, and select Project settings > Issue synchronization > New Synchronization > Synchronize with another project on this instance:

  2. Choose the project you want to synchronize issue data with, then click Next

  3. Assign a name and description. For now, let's stick with the default name and description – just click Next

  4. On the settings overview screen, check the configuration settings then click Send Request

  5. Now, any user with the Administer Projects permission for Cloud Project B can accept the synchronization request to establish the connection between the projects. To accept the request, open Cloud Project B and click Project settings > Issue synchronization > in the Actions column, click ... > View Request > Accept Request.

Congratulations, you've established a synchronization! Now, carry on and configure what issue types will be synchronized between the projects.

Synchronize two Jira projects on different instances 

To sync with a project on another instance, you need to send a 'Synchronization request' to the other instance, which the Jira administrators in the other instance can accept to establish a connection.

  1. Open the project you want to synchronize, and select Project settings > Issue synchronization > New Synchronization > Synchronize with another Cloud instance > Next:

  2. Based on your needs, either choose “immediate“ or “review“, and click Next

  3. In the Partner Instance column, enter the following data:

    1. In the Base URL field, enter the base URL of the Jira instance you want to synchronize with – it will have this structure: https://example.atlassian.net

    2. In the Project Key field, you can enter a specific project key of a project in the partner instance. Enter Cloud Project B's project key, and click Next

  4. For now, let's stick with the default name and description – just click Next

  5. Check the configuration settings, and click Send Request

  6. Now, any user with the Administer Projects permission for Cloud Project B can accept the synchronization request to establish the connection between the projects. To accept the request, open Cloud Project B and click Project settings > Issue synchronization > in the Actions column, click ... > View Request > Accept Request

Congratulations, you've established a synchronization! Now, carry on and configure what issue types will be synchronized between the projects.


JavaScript errors detected

Please note, these errors can depend on your browser setup.

If this problem persists, please contact our support.