Configuring Project links across Applications

Administer Bitbucket Data Center and Server

On this page

Still need help?

The Atlassian Community is here for you.

Ask the community

After connecting your Atlassian applications using Application Links, you can also connect the areas of those applications that contain information relating to your project or team using Project Links.

Below are some selection priority advantages you’ll get from Project Links that connect Jira and Bitbucket Data Center and Server:

  • When you create a feature branch from Jira, repositories from a linked Jira project will be prioritized in the list of repositories.

  • When you create a Jira issue from a comment in Bitbucket, the linked Jira project is pre-selected from the list of projects.

  • When you check the details of a Jira issue in Bitbucket, issues from linked Jira projects are shown higher in the issue view dialog. This is helpful when there are multiple issues with the same issue-key from different Jira instances.

  • When you check development details in Jira, commits and branches are shown higher in the development details dialog.


On this page:

Related pages:

You won’t be able to create a Project Link until you link Bitbucket to another application using Application Links.

  1. Go to  > Application links.

  2. Enter the URL of the application you want to link to and then click Create link.

  3. Finish configuring the link.

For more information on creating and using Application Links, see Link Atlassian applications to work together.

There are two types of Project Links:

  • 2-way Project Links are are reciprocal links that provide authorized access for Project Links to be created or deleted from both linked applications.

  • 1-way Project Links do not share authorized access to delete or create Project Links between linked applications.

To link a Bitbucket project to a project or space in another application when there are Application Links (requires project admin permissions):

  1. Go to Project settings > Project links.

  2. Click Create Project Link.

  3. The instructions for creating a Project Link will vary depending on whether Bitbucket has authorization:

  • If Bitbucket has authorization to create the Project Link:

    1. Choose the application that contains the project you want to link to.

    2. Choose a project to link to. If there are no projects listed, then all possible projects have already been linked.

    3. Select the Make this a 2-way Project Link checkbox if you want to create a reciprocal link from the target application to Bitbucket.

4. Click Create link.

  • If Bitbucket doesn't have authorization to create the Project Link:

    1. Choose the application that contains the project you want to link to.

    2. Choose one of the following options:

      • Don’t authorize Bitbucket Server - Click this option if you only need to create links to public projects.

      • Authorize Bitbucket Server - Click this option if you want to allow Bitbucket to create links to all projects on this application.

Making a project link the primary link gives it priority over other links. If you’ve set up Project Links to more than one project in the same application, for example you have linked your Bitbucket project to two Jira projects, then one of the Project Links will be marked as Primary

To make a Project Link the Primary link (requires project admin permissions):

  1. Go to Project settings > Project links.

  2. Next to the Project Link that you want to make Primary, select  > Make primary link.

Deleting a project link stops the two projects from sharing information.

To delete a project link (requires project admin permissions):

  1. Go to Project settings > Project links.

  2. Next to the Project Link that you want to delete, select  > Delete. If authorization is required, choose one of the following:

    • Authorize - Granting Bitbucket authorization to access to the linked application allows you to delete the 2-way Project Links between those applications.

    • Delete - Deleting without granting Bitbucket authorization to access to the linked application will restrict you to being able to delete only the 1-way link from Bitbucket to the linked applications. Links back to Bitbucket will need to be deleted in the linked applications Administration settings.

  3. (Optional) Select the option to delete the reciprocal link from the linked application to Bitbucket.

  4. Click Delete to delete the project link.

Last modified on May 31, 2023

Was this helpful?

Yes
No
Provide feedback about this article
Powered by Confluence and Scroll Viewport.